openITCOCKPIT-CE-docker

!openITCOCKPIT Logo

This repository contains the necessary files to run openITCOCKPIT Community Edition as a container.

It requires Docker Compose or a compatible alternative.

Please see the official documentation for more information: [***]

Prerequisites

Before running openITCOCKPIT Community Edition with Docker, make sure you have the following prerequisites installed on your system:

• Docker: Install Docker
• Docker Compose: Install Docker Compose

Supported architectures:

• amd64
• arm64v8

Getting Started

To get started with openITCOCKPIT Community Edition using Docker, follow these steps:

1. Clone this repository to your local machine:

   bash
   git clone [***]
   

2. Navigate to the cloned repository:

   bash
   cd openITCOCKPIT-ce-docker
   

3. Run the Docker Compose command to start openITCOCKPIT:

   bash
   docker compose up -d
   

4. Wait for the containers to start and initialize the application.

5. Once the containers are up and running, you can access openITCOCKPIT Community Edition by opening a web browser and entering the following URL:

   https://localhost
   

6. Follow the on-screen instructions to complete the initial setup of openITCOCKPIT.

Configuration

The configuration for openITCOCKPIT Community Edition can be modified by editing the compose.yml file in the repository. You can adjust settings such as database credentials, ports, and volumes according to your requirements.

Most settings can be adjusted through environment variables. Please see the file openitcockpit.env, which contains all available environment variables with default values.

By default, openITCOCKPIT Community Edition will expose these ports:

• 80 (HTTP)
• 443 (HTTPS)

The default credentials are:

• E-Mail ***
• Password: asdf12

You can change the default credentials before the first start of the docker container through the file openitcockpit.env:

sh
OITC_ADMIN_EMAIL=***
OITC_ADMIN_PASSWORD=asdf12
OITC_ADMIN_FIRSTNAME=John
OITC_ADMIN_LASTNAME=Doe

If you have not changed the default credentials, you can still change the password or create a new user afterwords.

Updating openITCOCKPIT

To update openITCOCKPIT Community Edition to the latest version, follow these steps:

1. Pull the latest changes from the repository:

   bash
   git pull origin main
   

2. Stop and remove the running containers:

   bash
   docker compose down
   

3. Run the Docker Compose command again to start the updated version:

   bash
   docker compose up --pull always -d
   

Troubleshooting

If you encounter any issues or have questions regarding openITCOCKPIT Community Edition with Docker, please refer to the official documentation.

Contributing

Contributions are welcome! If you find any bugs or have suggestions for improvements, please open an issue or submit a pull request in this repository.

Bugs or issues related to openITCOCKPIT itself should be created in the corresponding repository: [***]

License

Copyright (C) 2015-2025  it-novum GmbH
Copyright (C) 2025-today Allgeier IT Services GmbH

openITCOCKPIT is dual licensed

1)
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, version 3 of the License.


This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.


You should have received a copy of the GNU General Public License
along with this program.  If not, see <[***]>.

2)
If you purchased an openITCOCKPIT Enterprise Edition you can use this file
under the terms of the openITCOCKPIT Enterprise Edition licence agreement.
Licence agreement and licence key will be shipped with the order
confirmation.

Support

For any further assistance or support, please reach out to the openITCOCKPIT Community.