How do I upgrade my CoPilot application?

Taylor Walton

30-Jul-2025

Problem

Users of the CoPilot application may find that certain features are unavailable or missing from their interface.

Cause

This issue typically occurs when the CoPilot application is running an outdated version. Newer features and functionalities, like enhanced user management options, are introduced in later releases.

Resolution

To resolve this and gain access to the latest features, you need to upgrade your CoPilot application to the most recent version. Follow these steps to perform the upgrade:

Step-by-Step CoPilot Upgrade Process

1. Navigate to the CoPilot Installation Directory:

   Open your terminal or command prompt and change your current directory to where CoPilot is installed. The default location is /opt/CoPilot, but it may vary in your environment.

   cd /opt/CoPilot

   (Replace /opt/CoPilot with your actual CoPilot directory if different.)

2. Stop and Remove Existing CoPilot Containers:

   Shut down and remove the currently running CoPilot Docker containers to prepare for the upgrade.

   docker compose down

3. Pull the Latest CoPilot Docker Images:

   Download the most recent Docker images for CoPilot components.

   docker compose pull

4. Update Your .env File:

   New CoPilot versions may introduce new environment variables. Update your .env file to include any new entries by comparing it with the latest example file. You can find the latest example here: Latest .env.example

5. Update Your docker-compose.yml File:

   Similarly, the Docker Compose configuration file might have changes or new services. Update your docker-compose.yml file to reflect the latest changes from the official template. You can find the latest template here: Latest docker-compose.yml

6. Restart CoPilot with Updated Configuration:

   Once your environment and Docker Compose files are updated, start CoPilot using the new configuration.

   docker compose up -d

Verification

After completing these steps, log back into your CoPilot application. You should now see the "Add user" option and any other features introduced in the latest version. You can repeat these steps anytime a new version of CoPilot is released to keep your instance up-to-date.