How to update an Application?

Newer versions of applications often introduce changes that can break compatibility with our Coolify templates.

To ensure stability for all users, we pin each application to a specific version.

Tip

Before updating your app, create a new instance and test your changes there. This way, your current app and any important services using it won’t break.

If you’d like to update an application manually, follow the steps below:

Find the Target Version

Identify the version number you want to upgrade to (you can check the application github repository or website).

For example, if your current Appwrite version is v1 and you want to move to v4, note down the new version.

Review the Official Changelog

Go through the application’s official changelog to understand what has changed.

Check for:

  • New or removed environment variables
  • Additional or deprecated services in the docker-compose file
  • Configuration changes required for new features

Apply the Updates

Once you understand the required changes, follow these steps:

  • On Coolify and click “Edit Compose”
    Edit compose option on Coolify
  • Modify the compose file to include the new version and any necessary updates
    Edit compose modal on Coolify
  • Update the environment variables if needed: Environment Variables page on Coolify dashboard

    Tip

    If you add or remove environment variables on compose using the edit compose feature, then Coolify will automatically update the environment variables page on the dashboard.

  • Save your changes and redeploy the app
Last updated on 11/13/2025