How to Upload and Install New Panel Modules in Cockpit Print

Cockpit allows you to extend its functionality by adding new panel modules. This guide explains how to upload and install these modules through the Superadmin interface.

Method 1: Using the Module Uploader

1. Prepare the Module File
   • Download the module package (e.g., multi-service-proxy-2.5.1.zip) from the store
   • Extract the downloaded ZIP file
   • Locate the UPLOAD_proxy.zip file (or similar named file) inside the extracted contents
   • Note: Each module will have a file named UPLOAD_[modulename].zip
2. Access the Module Upload Page
   • Login to your Cockpit installation with Superadmin credentials
   • Navigate to the "Panel Modules" section
3. Upload the Module
   • Click the "Add Module..." or "Start Upload" button
   • Select the UPLOAD_[modulename].zip file you extracted earlier
   • Wait for the upload to complete
4. Verify Installation
   • Refresh the page after the upload completes
   • The new module should appear in the modules table
   • You should now see options to access the module's Settings, Pages, etc.

Enabling Automatic Updates

After installing a module, you can enable automatic updates to ensure it stays current:

1. Look for the "Disable Automatic Updates" button in the Panel Modules section
2. If it says "Disable Automatic Updates," automatic updates are currently enabled
3. If it says "Enable Automatic Updates," click it to turn on automatic updates

With automatic updates enabled, your modules will update themselves when new versions are available. Alternatively, you can manually download updates from store.cockpit.lol/downloads.php.

Method 2: Manual Installation via FTP or File Manager

If you encounter upload limitations due to your server's max_upload_size settings, you can install modules manually:

1. Prepare the Module Files
   • Extract the downloaded module package (e.g., multi-service-proxy-2.5.1.zip)
   • Extract the UPLOAD_[modulename].zip file you find inside
   • This will give you a folder structure that matches your Cockpit installation
2. Upload via FTP or File Manager
   • Connect to your server using FTP or your hosting control panel's file manager
   • Navigate to your Cockpit installation directory
   • Upload the extracted files, maintaining the folder structure
   • The files should be placed directly over your existing Cockpit installation
3. Verify Installation
   • Log in to your Cockpit Superadmin panel
   • Navigate to the "Panel Modules" section
   • Refresh the page if necessary
   • The new module should appear in the modules list

Important Notes

• Always keep a backup of your Cockpit installation before installing new modules
• Ensure your server meets any additional requirements specified for the module
• If a module doesn't appear after installation, check your server's error logs
• Some modules may require additional configuration after installation
• Modules should be compatible with your Cockpit version; check version requirements before installing

By following these steps, you can easily extend your Cockpit installation with additional modules and keep them updated with the latest features and security patches.