⭐️⭐️⭐️ Open-source, self-hosted alternative to Linear and Plane. Project management and issue tracking where teams and AI agents work side by side to plan and ship products.
TypeScript agenticagileai-agentsbug-reportingbug-trackerganttissue-trackerjirajira-alternativekanbanlinearlinear-alternativeopen-sourceproduct-managementproject-managementroadmapself-hostedsprint-planningteam-collaborationtrello-alternative
Deploy stack
- The deploy composes do not publish the Postgres port.
docker-compose.pro.ymlanddocker-compose.coolify-pro.ymlrun the published Pro images: migrate fromvendor/itsaplan/packages/db/src/migrate.ts, start the api with./pro-api. The Helm chart does the same withvalues-pro.yaml, which sets the Pro image repositories andpro: true.pro: truealone selects only the two paths, so the core images fail on it.- Migrations run as a separate step before the apps start:
- Compose: the one-shot
migrateservice. api, worker and bot wait for it. - Helm: the
migrateinit container of the api pods. Worker and bot pods wait in await-for-migrationsinit container. - Both run
migrate.tsfrom the api image. The api container sets its own command, which replaces the image CMD, so it only starts the server.
- Compose: the one-shot
- The api image's own CMD also runs the migrations before the server starts. Deploy targets
with no separate step (Railway, a plain
docker run) need this. - Every
migrate.tsrun takes a Postgres advisory lock, so runs that start together apply each migration only once. - When migrations are pending on an existing database,
migrate.tsrunspg_dumpintoBACKUP_DIR(default/backups) before it applies them. A failed dump stops the run, and no migration is applied. - Migrations run without a dump in three cases: on a new database, with
SKIP_PRE_MIGRATION_BACKUP=1, and throughbun run db:migrate, which uses drizzle-kit and skipsmigrate.ts, so it also takes no lock. - Where the dump is stored:
- Compose: the
db-backupsvolume, mounted on themigrateservice only. - Helm: the
backupsvolume of the api pods. It is anemptyDir, lost with the pod, unlessapi.backups.persistence.enabledis true. - With no volume at
/backups(Railway, a plaindocker run): the container filesystem, lost with the container.
- Compose: the
- Each
migrate.tsrun deletes dumps older thanBACKUP_RETENTION_DAYS(default 30).