Running Cockpit

If you already have Cockpit on your server, point your web browser to: https://ip-address-of-machine:9090

Use your system user account and password to log in. See the guide for more info.

Minimum client browser versions

  • Mozilla Firefox 11+
  • Google Chrome 16+
  • Microsoft Edge
  • Microsoft Internet Explorer 11
  • Apple Safari 6.1+
  • Opera 21.1+

Installation & Setup

  Supported Tested Included  
Fedora ✓ ✓ ✓ View instructions
Red Hat Enterprise Linux ✓ ✓ ✓ View instructions
Project Atomic ✓ ✓ ✓ View instructions
CentOS ✓ ✓ ✓ View instructions
Debian GNU/Linux ✓ ✓ ✓ View instructions
Ubuntu ✓ ✓ ✓ View instructions
Clear Linux     ✓ View instructions
Arch Linux       View instructions

Fedora

Cockpit comes installed by default in Fedora Server.

To install Cockpit on other variants of Fedora use the following commands. For the latest versions use COPR.

  1. Install cockpit: 
    sudo dnf install cockpit
  2. Enable cockpit: 
    sudo systemctl enable --now cockpit.socket
  3. Open the firewall if necessary: 
    sudo firewall-cmd --add-service=cockpit
sudo firewall-cmd --add-service=cockpit --permanent

Red Hat Enterprise Linux

Cockpit is included in the Red Hat Enterprise Linux Extras repository in versions 7.1 and later:

  1. Enable the Extras repository: 
    sudo subscription-manager repos --enable rhel-7-server-extras-rpms
  2. Install cockpit: 
    sudo yum install cockpit
  3. Enable cockpit: 
    sudo systemctl enable --now cockpit.socket
  4. Open the firewall if necessary: 
    sudo firewall-cmd --add-service=cockpit
sudo firewall-cmd --add-service=cockpit --permanent

Project Atomic

Connect to an Atomic Host from another instance of Cockpit with the Add Server dashboard UI.

Alternatively you can access Cockpit directly on the Atomic Host if SSH password authentication is enabled:

  1. Run the Cockpit web service container: 
    sudo atomic install cockpit/ws
sudo atomic run cockpit/ws

CentOS

Cockpit is included in CentOS 7.x:

  1. Install cockpit: 
    sudo yum install cockpit
  2. Enable cockpit: 
    sudo systemctl enable --now cockpit.socket
  3. Open the firewall if necessary: 
    sudo firewall-cmd --permanent --zone=public --add-service=cockpit
sudo firewall-cmd --reload

Debian

Cockpit is included in Debian unstable and in backports for Debian 8 (Jessie) and 9 (Stretch).

  1. For Debian 9 you have to enable the backports repository: 
    echo 'deb http://deb.debian.org/debian stretch-backports main' > \
 /etc/apt/sources.list.d/backports.list
apt-get update
  2. For Debian 8 you have to enable the backports-sloppy repository: 
    echo 'deb http://deb.debian.org/debian jessie-backports-sloppy main' > \
 /etc/apt/sources.list.d/backports.list
apt-get update
  3. Install the package: 
    sudo apt-get install cockpit

Ubuntu

Cockpit is included in Ubuntu 17.04 and later, and available as an official backport for 16.04 LTS and later. Backports are enabled by default, but if you customized apt sources you might need to enable them manually.

  1. Install the package:
sudo apt-get install cockpit

Clear Linux

Cockpit is in Clear Linux OS and can be installed using swupd:

sudo swupd bundle-add sysadmin-remote
sudo systemctl enable --now cockpit.socket

Arch Linux

Cockpit can be found in the Arch User Repository as package cockpit.