@panoptic-it-solutions/coolify-setup

CLI tool for setting up Coolify deployment on Panoptic projects.

Usage

``bash
npx @panoptic-it-solutions/coolify-setup
`

Or install globally:

`bash
npm i -g @panoptic-it-solutions/coolify-setup
coolify-setup
`

What it does

This CLI tool automates the setup of Coolify deployment for your project:

1. Detects your project type (Next.js or Node.js)
2. Detects your package manager (pnpm, npm, or yarn)
3. Generates deployment files:
- Dockerfile - Multi-stage build optimized for your project
- docker-compose.yml - Production configuration with optional services
- docker-compose.build.yml - Build configuration for CI
- .github/workflows/build-deploy.yml - GitHub Actions workflow
- entrypoint.sh - Container startup script with migration support
- .claude/rules/coolify.md - Coolify deployment rules for Claude
4. Sets up GitHub repository (optional):
- Creates repo in Panoptic-IT-Solutions org
- Pushes main, staging, and develop branches
- Sets develop as default branch

Hardcoded Panoptic Defaults

- Registry: 10.0.0.2:5000
- GitHub Org: Panoptic-IT-Solutions
- CI Runner: self-hosted
- Branch Strategy:
- develop - Default branch for development
- staging - Deploy target for all branches
- main - Production (manual promotion)

Optional Services

The CLI will prompt you to include:
- PostgreSQL (with automatic migration support)
- Redis
- MinIO (S3-compatible storage)

Migration Handling

If PostgreSQL is included, the CLI generates migration infrastructure:

$3

Next.js uses output: 'standalone' which creates a minimal deployment without full node_modules. To handle migrations:

1. esbuild is added to devDependencies (automatically)
2. Migration script is bundled at Docker build time into a single JS file with all dependencies
3. Bundled JS runs with plain Node.js at container startup (no tsx needed)

Files generated:
- lib/db/migrate.ts - Migration script source (if not existing)
- lib/db/migrate.bundle.js - Bundled migration (created during Docker build)

$3

Node.js projects keep full node_modules, so migrations run with tsx:

Files generated:
- scripts/migrate.ts - Migration script
- Uses npx tsx at runtime

$3

- Skips during Docker build - Detects placeholder database URLs
- Runs on container startup - Before the application starts
- Idempotent - Drizzle tracks applied migrations

Requirements

- Node.js 18+
- GitHub CLI (gh`) installed and authenticated (for repo creation)
- Git initialized in your project
- For Next.js + PostgreSQL: esbuild (automatically added to devDependencies)

License

MIT