core

Installation

Setup
Docker
Troubleshooting
Cockpit displays a blank page
Cockpit does not save changes correctly

Setup

The following steps describe the setup of a fresh new installation of Cockpit.

Download the latest version of Cockpit
Extract the archive
Deploy files to your webserver's root directory (or any sub-folder)
Navigate to your Cockpit installation folder at /install/
Ensure write permissions for the /storage directory.
Open the administration panel
Login with username admin and generated password
Congratulations! You managed to install Cockpit successfully.

Note

To make the installation process as simple as possible, Cockpit creates a default admin account. Please change the password after your first login.

Docker

Pull the Cockpit CMS Docker image from Docker Hub (Core or Pro):

CORE:

docker pull cockpithq/cockpit:core-latest

PRO:

docker pull cockpithq/cockpit:pro-latest

Run the Cockpit CMS container:

docker run -d --name cockpit -p 8080:80 cockpithq/cockpit:pro-latest

This starts a Cockpit CMS container named cockpit, accessible on port 8080.

Access Cockpit CMS by navigating to http://localhost:8080/install in your web browser.

If you need to persist data or configure Cockpit further, you might consider mounting a volume for the .spaces, storage and config directory or customizing the Docker container to suit your needs.

Troubleshooting

Cockpit displays a blank page

If you see a blank page we recommend checking your server logs. Next make sure you display PHP error messages. In most cases you should see some errors where the blank page was displayed before.

Cockpit does not save changes correctly

If changes to your content, content-models, settings or anything else you administer in Cockpit's admin panel get lost, please check the directory write permissions for your Cockpit installation as described in Setup.