# Cockpit

From ArchWiki
Jump to navigation Jump to search
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

Cockpit is a browser-based administration tool for Linux, sponsored by Red Hat.

## Installation

Install the cockpit package. Check the optional dependencies to see what packages are required to manage network connections, packages and hard disks.

For additional features, install one of the following packages:

- cockpit-machines for managing virtual machines using libvirt
- cockpit-pcp for reading PCP metrics and loading PCP archives
- cockpit-podman for managing Podman containers (replaces cockpit-docker)

## Usage

Start/enable the `cockpit.socket` unit to start Cockpit [1].

Visit https://localhost:9090/ in a web browser to use Cockpit. Log in with your Linux account and password.

## Configuration

### TLS certificate

By default, Cockpit uses a self-signed TLS certificate. To use proper certificate, put a certificate with suffix `.cert` and a corresponding key with suffix `.key` in the `/etc/cockpit/ws-certs.d/` directory. Cockpit will use the last `*.cert` file in that folder, in alphabetical order, falling back on `0-self-signed.cert`. The cert and key have to be readable by the cockpit-ws user. Restart `cockpit.service` to apply. See the page in the official docs for more information.

Categories:

- System administration
- Web admin interfaces