You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
stale-issue-message: 'This issue will be automatically closed in a few days if no response is received. Please provide an update with the requested information.'
16
+
stale-pr-message: 'This pull request will be automatically closed in a few days if no response is received. Please update your PR or comment if you would like to continue working on it.'
17
+
close-issue-message: 'This issue has been automatically closed due to inactivity.'
18
+
close-pr-message: 'This pull request has been automatically closed due to inactivity.'
19
+
days-before-stale: 14
20
+
days-before-close: 7
21
+
stale-issue-label: '⏱︎ Stale'
22
+
stale-pr-label: '⏱︎ Stale'
23
+
only-labels: '💤 Waiting for feedback'
24
+
remove-stale-when-updated: true
25
+
operations-per-run: 100
26
+
labels-to-remove-when-unstale: '⏱︎ Stale, 💤 Waiting for feedback'
This guide outlines the release process for Coolify, intended for developers and those interested in understanding how releases are managed and deployed.
4
4
5
+
## Table of Contents
6
+
-[Release Process](#release-process)
7
+
-[Version Types](#version-types)
8
+
-[Stable](#stable)
9
+
-[Nightly](#nightly)
10
+
-[Beta](#beta)
11
+
-[Version Availability](#version-availability)
12
+
-[Self-Hosted](#self-hosted)
13
+
-[Cloud](#cloud)
14
+
-[Manually Update to Specific Versions](#manually-update-to-specific-versions)
15
+
5
16
## Release Process
6
17
7
-
1.**Development on `next` or separate branches**
8
-
-Changes, fixes and new features are developed on the `next` or even separate branches.
18
+
1.**Development on `next` or Feature Branches**
19
+
-Improvements, fixes, and new features are developed on the `next`branch or separate feature branches.
9
20
10
21
2.**Merging to `main`**
11
-
- Once changes are ready, they are merged from `next` into the `main` branch.
22
+
- Once ready, changes are merged from the `next` branch into the `main` branch.
12
23
13
-
3.**Building the release**
14
-
- After merging to `main`, a new release is built.
15
-
- Note: A push to `main` does not automatically mean a new version is released.
24
+
3.**Building the Release**
25
+
- After merging to `main`, GitHub Actions automatically builds release images for all architectures and pushes them to the GitHub Container Registry with the version tag and the `latest` tag.
16
26
17
-
4.**Creating a GitHub release**
18
-
- A new release is created on GitHub with the new version details.
27
+
4.**Creating a GitHub Release**
28
+
- A new GitHub release is manually created with details of the changes made in the version.
19
29
20
30
5.**Updating the CDN**
21
-
- The final step is updating the version information on the CDN:
- To make a new version publicly available, the version information on the CDN needs to be updated: [https://cdn.coollabs.io/coolify/versions.json](https://cdn.coollabs.io/coolify/versions.json)
23
32
24
33
> [!NOTE]
25
-
> The CDN update may not occur immediately after the GitHub release. It can happen hours or even days later due to additional testing, stability checks, or potential hotfixes.
26
-
34
+
> The CDN update may not occur immediately after the GitHub release. It can take hours or even days due to additional testing, stability checks, or potential hotfixes. **The update becomes available only after the CDN is updated.**
> Do not use nightly/beta builds in production as there is no guarantee of stability.
27
86
28
87
## Version Availability
29
88
30
-
It's important to understand that a new version released on GitHub may not immediately become available for users to update (through manual or auto-update).
89
+
When a new version is released and a new GitHub release is created, it doesn't immediately become available for your instance. Here's how version availability works for different instance types.
90
+
91
+
### Self-Hosted
92
+
93
+
- **Update Frequency:** More frequent updates, especially on the nightly release channel.
94
+
- **Update Availability:** New versions are available once the CDN has been updated.
95
+
- **Update Methods:**
96
+
1. **Manual Update in Instance Settings:**
97
+
- Go to `Settings > Update Check Frequency` and click the `Check Manually` button.
98
+
- If an update is available, an upgrade button will appear on the sidebar.
99
+
2. **Automatic Update:**
100
+
- If enabled, the instance will update automatically at the timesetin the settings.
101
+
3. **Re-run Installation Script:**
102
+
- Run the installation script again to upgrade to the latest version available on the CDN:
> If a new release is available on GitHub but your instance hasn't updated yet or no upgrade button is shown in the UI, the CDN might not have been updated yet. This intentional delay ensures stability and allows for hotfixes before official release.
109
+
110
+
### Cloud
111
+
112
+
- **Update Frequency:** Less frequent as it's a managed service.
113
+
- **Update Availability:** New versions are available once Andras has updated the cloud version manually.
114
+
- **Update Method:**
115
+
- Updates are managed by Andras, who ensures each cloud version is thoroughly tested and stable before releasing it.
31
116
32
117
> [!IMPORTANT]
33
-
> If you see a new release on GitHub but haven't received the update, it's likely because the CDN hasn't been updated yet. This is intentional and ensures stability and allows for hotfixes before the new version is officially released.
118
+
>The cloud version of Coolify may be several versions behind the latest GitHub releases even ifthe CDN is updated. This is intentional to ensure stability and reliabilityforcloud users and Andras will manully update the cloud version when the update is ready.
34
119
35
120
## Manually Update to Specific Versions
36
121
@@ -42,4 +127,4 @@ To update your Coolify instance to a specific (unreleased) version, use the foll
0 commit comments