Installing Extensions

In this guide, you will learn how to install .c7s.zip extensions in your Calagopus Panel.

This process is meant to be done via either the :heavy docker image or a full development environment, nothing in between. If you are using the regular :latest or :nightly docker image, you will need to switch it over to :heavy (or :nightly-heavy) to be able to install extensions. Click here to view the guide on how to change the Docker image variant.

Install an Extension

To install an extension, the steps will vary depending on whether you are using the Docker image or a local installation. Use the tabs below to navigate to the instructions for your installation method.

The process for installing extensions with the Docker image pretty straightforward. First, ensure you are using the :heavy or :nightly-heavy Docker image variant, as the regular :latest and :nightly images do not include the necessary tools to install extensions. Click here to view the guide on how to change the Docker image variant.

Then, after you have ran docker compose up -d to (re)start the Panel with the new image variant, you can then access the extension management page in the Panel and upload the .c7s.zip file for your extension. The Panel will handle the rest of the installation process for you.

Alternatively, you can also copy the .c7s.zip file for your extension directly into the extensions directory of the Panel's data volume. If you are using the default heavy compose stack, this will be at ./build/extensions relative to your compose file. The Panel will automatically detect the new extension and install it for you after you restart the Container. (e.g. by running docker compose restart web).