Skip to content

Latest commit

 

History

History
276 lines (209 loc) · 7.7 KB

running.md

File metadata and controls

276 lines (209 loc) · 7.7 KB
title class
Running Cockpit
running-cockpit body-cockpit

{% capture newline %} {% endcapture %}

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.

After installing Cockpit itself, consider installing additional applications in Cockpit.

Recommended client browsers

{% capture icon %}{:.browser-0}{% endcapture %} {% capture label %}0{% endcapture %}

Cockpit is developed with and has automated tests for:

{:.browser-support}

  • {{icon | replace: "0", "firefox"}}{{label | replace: "0", "Mozilla Firefox"}}
  • {{icon | replace: "0", "chrome"}}{{label | replace: "0", "Google Chrome"}}

Cockpit is also periodically checked with:

{:.browser-support}

  • {{icon | replace: "0", "edge"}}{{label | replace: "0", "Microsoft Edge"}}
  • {{icon | replace: "0", "safari"}}{{label | replace: "0", "Apple Safari"}} [iPhones, iPads, and macOS on ARM/M1 may require a workaround]({{ site.baseurl }}/running/safari.html){:.note-safari}
  • {{icon | replace: "0", "epiphany"}}{{label | replace: "0", "GNOME Web (Epiphany)"}}
Your current browser should work with Cockpit.
Sorry! Your current browser appears to lack necessary features.

Minimum client browser versions

The following browsers (and up) may also work with Cockpit:

{% comment %}

Data for the browser table comes from _data/browsers.yml

Browser versions come from _data/browser_support.yml (generated)

Browser features are defined in _scripts/update-browser-data.rb

{% endcomment %}

{:.browser-support} {% for browser in site.data.browsers %}{% assign slug = browser.name | downcase %}

  • {{ browser.vendor }} {{ browser.name }} {% assign ver_caniuse = site.data.browser_support["browsers"][slug] | plus: 0 %}{% assign ver_caniuse_float = ver_caniuse | plus: 0 %}{% if browser.version > ver_caniuse_float %}{{ browser.version }}{% else %}{{ ver_caniuse }}{% endif %}{% endfor %}

However, we strongly encourage you to use the latest version of your browser for security reasons.

Installation & Setup

{% comment %}

Data for the distros table comes from _data/distros.yml

{% endcomment %} {% assign check = '✓' %}

| |Supported|Tested|Included|| |-|-|-|-|-|-|{% for distro in site.data.distros %} |[![{{ distro.name }}](/images/site/os-{{ distro.first}}.svg)](#{{ distro.first }})|{% if distro.supported %}{{ check | replace: "#", "supported" }}{% endif %}|{% if distro.tested %}{{ check | replace: "#", "tested" }}{% endif %}|{% if distro.included %}{{ check | replace: "#", "included" }}{% endif %}|[View instructions](#{{ distro.first }})|{% endfor %} {:.support-table}

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
  1. Enable cockpit:
sudo systemctl enable --now cockpit.socket
  1. Open the firewall if necessary:
sudo firewall-cmd --add-service=cockpit
sudo firewall-cmd --add-service=cockpit --permanent

Red Hat Enterprise Linux

{:#rhel}

Cockpit is included in Red Hat Enterprise Linux 7 and later.

  1. On RHEL 7, enable the Extras repository.
sudo subscription-manager repos --enable rhel-7-server-extras-rpms

RHEL 8 does not need any non-default repositories.

  1. Install cockpit:
sudo yum install cockpit
  1. Enable cockpit:
sudo systemctl enable --now cockpit.socket
  1. On RHEL 7, or if you use non-default zones on RHEL 8, open the firewall:
sudo firewall-cmd --add-service=cockpit
sudo firewall-cmd --add-service=cockpit --permanent

Fedora CoreOS

{:#coreos}

The standard Fedora CoreOS image does not contain Cockpit packages.

  1. Install Cockpit packages as overlay RPMs:

    rpm-ostree install cockpit-system cockpit-ostree cockpit-podman

    Depending on your configuration, you may want to use other cockpit-* extensions as well, such as cockpit-kdump or cockpit-networkmanager.

    If you have a custom-built OSTree, simply include the same packages in your build.

  2. Reboot

Steps 1 and 2 are enough when the CoreOS machine is only connected to through another host running Cockpit.

If you want to also run a web server to log in directly on the CoreOS host:

  1. Enable password based SSH logins, unless you only use SSO logins:

    echo 'PasswordAuthentication yes' | sudo tee /etc/ssh/sshd_config.d/02-enable-passwords.conf
sudo systemctl try-restart sshd

  2. Run the Cockpit web service with a privileged container (as root):

    podman container runlabel --name cockpit-ws RUN docker.io/cockpit/ws

  3. Make Cockpit start on boot:

    podman container runlabel INSTALL docker.io/cockpit/ws
systemctl enable cockpit.service

Afterward, use a web browser to log into port 9090 on your host IP address as usual.

CentOS

Cockpit is included in CentOS 7.x:

  1. Install cockpit:
sudo yum install cockpit
  1. Enable cockpit:
sudo systemctl enable --now cockpit.socket
  1. 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 10 (Buster).

  1. For Debian 10 you have to enable the backports repository:
echo 'deb http://deb.debian.org/debian buster-backports main' > \
    /etc/apt/sources.list.d/backports.list
apt update
  1. Install the package:
sudo apt install -t buster-backports cockpit

{:.note} When installing and updating Cockpit-related packages and any dependencies, make sure to use -t buster-backports so backports are included.

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

{:#clearlinux}

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

{:#archlinux}

Cockpit is included in Arch Linux:

sudo pacman -S cockpit
sudo systemctl enable --now cockpit.socket

If the first command fails with "database file for ... does not exist", refresh/update your system with sudo pacman -Syu first.

openSUSE Tumbleweed

{:#tumbleweed}

Cockpit is included in openSUSE Tumbleweed:

  1. Install cockpit:
# zypper in cockpit
  1. Enable cockpit:
# systemctl enable --now cockpit.socket
  1. Open the firewall if necessary:
# firewall-cmd --permanent --zone=public --add-service=cockpit
# firewall-cmd --reload