= Cockpit =

'''`cockpit(1)`''' is a server administration tool with a web interface.

<<TableOfContents>>

----



== Installation ==

[[Linux/Fedora|Fedora]] and many derivative distributions have `cockpit(1)` preinstalled and running by default. For other [[Linux]] distributions, a `cockpit` package may be available.

Official plugins are available in separate packages, such as `cockpit-machines` (an interface to `libvirtd(8)`) and `cockpit-podman` (an interface to [[Podman|podman(1)]]).

----



== Setup ==

[[Linux/Systemd|Start and enable]] `cockpit.socket`.



=== Encryption ===

By default, `cockpit(1)` uses a self-signed [[Encryption/SSL|SSL]]/[[Encryption/TLS|TLS]] certificate. This can be replaced with a valid one.

The '''last''' file with a `.cert` or `.crt` extension ''(in alphabetical order)'' in `/etc/cockpit/ws-certs.d` will be used. Try `/usr/libexec/cockpit-certificate-ensure --check` to verify that the correct certificate will be detected.

----



== Usage ==



----



== Troubleshooting ==

=== Terminal text appears as rainbow boxes ===

A known interaction of '''Xterm.js''' project and the '''Firefox''' browser.

 1. Double check for an 'Allow access to the HTML5 canvas?' popup. This needs to be enabled.
 2. Try disabling `privacy.resistFingerprinting`.

----



== See also ==

[[https://man.archlinux.org/man/cockpit.1|cockpit(1)]]

[[https://cockpit-project.org/documentation.html|Cockpit project documentation]]



----
CategoryRicottone