1 cockpit
Luca Matteo Spoljarevic edited this page 2026-02-27 21:44:07 +01:00
This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Cockpit

Cockpit is a web-based server administration interface. This folder holds the configuration that controls how Cockpits web service behaves.

What the config does

  • cockpit.conf Configures the Cockpit WebService:
    • Origins Allowed origins for the web UI (HTTPS/WSS for your IP, hostname, and optional subdomain).
    • ProtocolHeader Header used to detect forwarded protocol (e.g. behind a reverse proxy): X-Forwarded-Proto.
    • AllowUnencrypted Allows unencrypted access for the given address (e.g. ip-adress), useful for local or reverse-proxy setups.

How to use it

  1. Install Cockpit (e.g. cockpit and optionally cockpit-machines, cockpit-podman, etc.).
  2. Copy or symlink this config to the system config (e.g. /etc/cockpit/cockpit.conf or the path your distro uses).
  3. Replace placeholders:
    • ip-adress → your server IP or hostname.
    • computername → your machines hostname.
    • subdomain.domain.tld → your public URL if you use one.
  4. Start/enable the Cockpit socket or service, then open https://<your-server>:9090 in a browser.

File reference

File Purpose
cockpit.conf WebService origins, protocol header, allow unencrypted