Skip to content

armgit / kaneo

Public Imported from GitHub
0

⚡ Project management that doesn't become the project. Boards, Gantt charts, and GitHub integration. Self-host it or use Kaneo Cloud.

fix(coolify): track the latest release instead of a broken pinned tag

Andrej7aec7d623dba
diff --git a/apps/docs/core/deployments/coolify.mdx b/apps/docs/core/deployments/coolify.mdx
index f1541c38b..faa67fd13 100644
--- a/apps/docs/core/deployments/coolify.mdx
+++ b/apps/docs/core/deployments/coolify.mdx
@@ -20,14 +20,14 @@ Kaneo ships a [Coolify-optimized Docker Compose file](https://github.com/usekane
- `AUTH_SECRET` (auto-generated 64-character hex, editable).
- PostgreSQL password (auto-generated, shared with both services).
- **Do not set `KANEO_API_URL`** to `localhost` or an internal address. Leave it unset — the container derives it from `KANEO_CLIENT_URL` (`https://kaneo.example.com/api`). The browser must reach the API over the same public domain, not a host-internal URL.
- - `KANEO_IMAGE_TAG` (optional): the Kaneo image version to deploy. It defaults to a pinned release tag; set it only to upgrade to a specific version.
+ - `KANEO_IMAGE_TAG` (optional): the Kaneo image version to deploy. It defaults to `latest`; set it to a release tag such as `2.20.0` to hold the deployment on a known version.
6. **Deploy**.
## What the Compose File Sets Up
- **PostgreSQL 16** with a persistent volume; Kaneo waits for its health check before starting.
- **Kaneo bundled image** (nginx + API in one container) on port `5173`.
-- **Pinned Kaneo version**: the image is pinned to a specific release tag (not `latest`) so redeploys are deterministic. Upgrade by setting `KANEO_IMAGE_TAG` to a newer release tag.
+- **Kaneo version**: the image tracks `latest`, so a redeploy picks up the newest release. The API runs database migrations on startup, so set `KANEO_IMAGE_TAG` to a release tag if you would rather upgrade deliberately.
- **`KANEO_API_URL` is derived automatically** from `KANEO_CLIENT_URL` by the container entrypoint — no extra API URL configuration needed.
- **No host port mappings or custom networks**: Coolify's proxy handles all external traffic.
diff --git a/compose.coolify.yml b/compose.coolify.yml
index a777a7f1b..f37bdefd3 100644
--- a/compose.coolify.yml
+++ b/compose.coolify.yml
@@ -10,8 +10,8 @@
# The only required environment variable is KANEO_CLIENT_URL (your public URL, without :5173).
# AUTH_SECRET and the PostgreSQL password are auto-generated via Coolify magic variables.
# Do NOT set KANEO_API_URL — the entrypoint derives it from KANEO_CLIENT_URL (public URL + /api).
-# The Kaneo image is pinned to a release tag so redeploys are deterministic; bump
-# KANEO_IMAGE_TAG (or the tag below) to upgrade intentionally.
+# The Kaneo image tracks the latest release by default. Set KANEO_IMAGE_TAG to a
+# release tag to hold a deployment on a known version.
services:
postgres:
@@ -30,9 +30,10 @@ services:
retries: 5
kaneo:
- # Pin to a specific release: the API runs database migrations on startup, so a
- # surprise upgrade can be risky. Bump KANEO_IMAGE_TAG to upgrade intentionally.
- image: ghcr.io/usekaneo/kaneo:${KANEO_IMAGE_TAG:-v2.18.0}
+ # Tracks the latest release. The API runs database migrations on startup, so
+ # set KANEO_IMAGE_TAG to a release tag if a redeploy should stay on a known
+ # version rather than pick up whatever is newest.
+ image: ghcr.io/usekaneo/kaneo:${KANEO_IMAGE_TAG:-latest}
environment:
- KANEO_CLIENT_URL=${KANEO_CLIENT_URL:?}
- AUTH_SECRET=${SERVICE_HEX_64_KANEO:?}