Cockpit


Table of Contents
1. Cockpit (Server Administration)
1.1. Using Cockpit
1.2. Features
1.2.1. System Dashboard
1.2.2. Viewing System Logs
1.2.3. Managing Storage
1.2.4. Networking
1.2.5. Services
1.2.6. Web Terminal

1. Cockpit (Server Administration)

Cockpit is a server manager that makes it easy to administer GNU/Linux servers via a web browser. On a FreedomBox, controls are available for many advanced functions that are not usually required. A web based terminal for console operations is also available.

It can be accessed by any user on your FreedomBox belonging to the admin group.

Caution

Use cockpit only if you are an administrator of GNU/Linux systems with advanced skills. FreedomBox tries to coexist with changes to system by system administrators and system administration tools like Cockpit. However, improper changes to the system might causes failures in FreedomBox functions.


1.1. Using Cockpit

Install Cockpit like any other application on FreedomBox. Make sure that Cockpit is enabled after that.

Ensure that the user account on FreedomBox that will used for Cockpit is part of the administrators group.

Launch the Cockpit web interface. Login using the configured user account.

Start using cockpit.

Cockpit is usable on mobile interfaces too.


1.2. Features

The following features of Cockpit may be useful for advanced FreedomBox users.


1.2.1. System Dashboard

Cockpit has a system dashboard that

  • Shows detailed hardware information

  • Shows basic performance metrics of a system

  • Allows changing system time and timezone

  • Allows changing hostname. Please use FreedomBox UI to do this

  • Shows SSH server fingerprints


1.2.2. Viewing System Logs

Cockpit allows querying system logs and examining them in full detail.


1.2.3. Managing Storage

Cockpit allows following advanced storage functions:

  • View full disk information

  • Editing disk partitions

  • RAID management


1.2.4. Networking

Cockpit and FreedomBox both rely on NetworkManager to configure the network. However, Cockpit offers some advanced configuration not available on FreedomBox:

  • Route configuration

  • Configure Bonds, Bridges, VLANs


1.2.5. Services

Cockpit allows management of services and periodic jobs (similar to cron).


1.2.6. Web Terminal

Cockpit offers a web based terminal that can be used perform manual system administration tasks.