mirror of
https://github.com/coollabsio/coolify-docs.git
synced 2026-06-19 07:35:55 +00:00
Andras Bacsai
a64450ae9d
Replace VitePress/Vue stack with Fumadocs MDX, TanStack Start, React 19, and Vite. Migrate all documentation content to MDX under content/docs/. Add full src/ app with React components, routing, search, and API page. Remove Korrektly integration from CI/CD workflows, Dockerfile, and env vars. Update build pipeline to output to .output/public instead of docs/.vitepress/dist.
108 lines
3.7 KiB
Plaintext
108 lines
3.7 KiB
Plaintext
---
|
||
title: Upgrading Coolify
|
||
description: Upgrade self-hosted Coolify automatically, semi-automatically with UI notifications, or manually via terminal with version-specific installation.
|
||
---
|
||
|
||
<ZoomImage src="/docs/images/get-started/upgrade/banner.webp" alt="Coolify banner" />
|
||
|
||
<br />
|
||
|
||
If you're using [Coolify Cloud](https://coolify.io/pricing/), the Coolify team handles all updates so you don’t need to worry about them.
|
||
|
||
For those who **self-host** Coolify, there are three ways to upgrade your instance:
|
||
|
||
- [Automatic Upgrade:](#_1-automatic-upgrade) For users who want easy, hands-off updates.
|
||
- [Semi-Automatic Upgrade:](#_2-semi-automatic-upgrade) For users who want control over when to apply updates.
|
||
- [Manual Upgrade:](#_3-manual-upgrade) For advanced users who prefer to manage the upgrade process themselves.
|
||
|
||
|
||
<Callout type="error" title="Backup First!">
|
||
|
||
|
||
- Always back up your Coolify data before starting an upgrade.
|
||
|
||
</Callout>
|
||
|
||
|
||
## 1. Automatic Upgrade
|
||
|
||
Coolify can update itself automatically. This option keeps your instance always up-to-date without any extra effort.
|
||
|
||
### How it works?
|
||
|
||
Coolify periodically checks the [CDN](https://cdn.coollabs.io/coolify/versions.json) for updates. When a new version is available, it automatically fetches the latest release from the [official repository](https://github.com/orgs/coollabsio/packages?repo_name=coolify) and starts the upgrade process on its own.
|
||
|
||
### Customize Automatic Updates
|
||
|
||
If you’d rather manage updates yourself, you can disable auto-updates in your Coolify dashboard’s Settings.
|
||
|
||
<ZoomImage src="/docs/images/get-started/upgrade/disable-auto-update.webp" alt="Disable Auto Update" />
|
||
|
||
|
||
<Callout type="info" title="Tip">
|
||
|
||
Turning off automatic updates lets you test a new version on a staging setup before updating your live environment.
|
||
|
||
</Callout>
|
||
|
||
|
||
## 2. Semi-Automatic Upgrade
|
||
|
||
This option gives you a bit more control. Coolify notifies you when an update is available, and you decide when to apply it.
|
||
|
||
### How it works?
|
||
|
||
Coolify periodically checks the [CDN](https://cdn.coollabs.io/coolify/versions.json) for updates. When a new version is available, you will see an "**Upgrade**" button in the sidebar of your Coolify dashboard.
|
||
|
||
<ZoomImage src="/docs/images/get-started/upgrade/upgrade-button-ui.webp" alt="Upgrade Button Ui" />
|
||
|
||
Click the upgrade button to start the update process.
|
||
|
||
### Set Update Frequency
|
||
|
||
You can also choose how often Coolify checks for updates by adjusting the settings (daily, weekly, etc.).
|
||
|
||
<ZoomImage src="/docs/images/get-started/upgrade/change-frequency.webp" alt="Change Frequency" />
|
||
|
||
|
||
<Callout type="info" title="Tip:">
|
||
|
||
This method is perfect if you want to review update details or test the upgrade before applying it.
|
||
|
||
</Callout>
|
||
|
||
|
||
## 3. Manual Upgrade
|
||
|
||
For those who prefer full control, you can upgrade Coolify manually.
|
||
|
||
### How to do this?
|
||
|
||
Open your server's terminal and run the command below:
|
||
|
||
```bash
|
||
curl -fsSL https://cdn.coollabs.io/coolify/install.sh | bash
|
||
```
|
||
|
||
To upgrade to a specific version, run the following command in your terminal:
|
||
|
||
```bash
|
||
curl -fsSL https://cdn.coollabs.io/coolify/install.sh | bash -s 4.0.0-beta.400
|
||
```
|
||
|
||
Replace `4.0.0-beta.400` with the version number you want to upgrade to.
|
||
|
||
### How it works?
|
||
|
||
This command runs the official [Coolify installation script](https://github.com/coollabsio/coolify/blob/main/scripts/install.sh). The script checks the [CDN](https://cdn.coollabs.io/coolify/versions.json) for the latest version and updates your Coolify Instance.
|
||
|
||
|
||
<Callout type="success" title="Tip">
|
||
|
||
In the Automatic and Semi-Automatic methods, Coolify runs the installation script automatically in the background.
|
||
|
||
In the Manual upgrade method, you run the script yourself.
|
||
|
||
</Callout>
|
||
|