⚡
COOLIFY GITHUB DEPLOYMENT
Puzzle #55 · Production Studio · Next.js & Coolify v4
DEPLOYMENT: RUNNING

Puzzle me this #55: Deploy a GitHub repo using Coolify

You must: (1) Create a GitHub app in Coolify assigned to your repo, (2) Show the deployment is running in Coolify, (3) Prove the deployment is live in the browser.

💡 Clue: Visit the Coolify docs on deploying repos from Github
🔒 https:// theme-oak.coolify.local
[Inspect Traefik Proxy Headers]
COOLIFY RESOURCE: theme-oak-example (localhost) · Commit 3017250
PORT 3000 -> 443 (SSL)

Scandinavian Precision in Solid White Oak

Architectural seating and bespoke millwork engineered with certified Nordic oak. Built with Next.js 15, styled with Tailwind CSS, and continuously deployed via Coolify GitHub App webhooks.

🪑
Natural Nordic White Oak
FSC Certified · Matte Polyurethane Coating
FINISH CUSTOMIZER (INTERACTIVE)
STATUS: HTTP 200 OK
SSR LATENCY: 14ms
DEPLOYED COMMIT: 3017250
REVERSE PROXY: Traefik (localhost:3000)
n8n-apps ▶ production ▶ theme-oak-example (localhost) Running (unknown) ⚠
Advanced :
Configuration
Deployments
Logs
Terminal
Links :
Deployments (1) < Page 1 of 1 >
Success
Started: 2026-03-07 21:53:31 UTC
Ended: 2026-03-07 21:56:20 UTC
Duration: 02m 49s
Elapsed: Finished 2 minutes ago
Commit: 3017250 - feat: initialize Next.js project with Tailwind CSS, global styles, and...
Manual
Coolify Build & Deployment Logs — theme-oak-example ● LIVE STREAM
==> Initializing Coolify deployment pipeline for theme-oak-example...
Repository: github.com/user/theme-oak-example (via GitHub App: theme-oak-example)
Target Commit: 3017250 | Branch: main | Trigger: Manual
==> Nixpacks build engine detecting runtime environment...
==> Found package.json: Node.js 20.x, Next.js 15.0.0, Tailwind CSS 3.4.1
==> Running phase: setup
==> Running phase: install (npm ci)
✓ npm ci completed in 14.2s (618 packages installed)
==> Running phase: build (npm run build)
✓ Compiled /app/layout.tsx in 3.4s
✓ Compiled /app/page.tsx (Theme Oak Scandinavian Catalog) in 1.8s
✓ Generating static pages (5/5)
✓ Output: Next.js standalone server package generated (118 MB)
==> Packaging Docker container image: clfy-theme-oak:3017250
==> Starting container on localhost:3000...
==> Registering Traefik router: Host(`theme-oak.coolify.local`) -> container:3000
✓ Health check passed (HTTP 200 on /). Container status: Running (unknown)
==> Deployment successful in 02m 49s! Ready to serve traffic.

Sources

Git sources for your applications.

Coolify v4.0.0-beta.403 · Root Team
🐙
theme-oak-example
GitHub App · Installation #482910
ASSIGNED
🔒
internal-services
GitHub App · (Redacted)
SYSTEM
🔒
n8n-infra-workflows
GitHub App · (Redacted)
SYSTEM
1
Source Creation
Coolify Sources -> + Add
2
GitHub App Manifest
Webhooks & Scopes
3
Repository Assignment
Assign theme-oak-example
4
Handshake & Keys
Private RSA & App ID
Step 3: Repository Assignment on GitHub
The core requirement: Assigning the GitHub App specifically to theme-oak-example.
Repository access policy:
CONFIGURED
📁 atillaisik / theme-oak-example
✓ ASSIGNED

📚 Decoding the Clue: Coolify Git Matrix

The clue advises visiting the Coolify docs on deploying repos from GitHub. The documentation details three methods:

1. GitHub App (Required & Recommended)
Provides automated webhooks for push-to-deploy, PR preview deployments, zero token management, and granular per-repo permissions.
2. Deploy Keys (SSH)
Read-only single repo access. Requires manual SSH key generation and lacks native PR preview triggers.
3. Public Repositories
Zero authentication required, but lacks automated push triggers without external CI/CD integrations.

⚠️ 5 Critical Deployment Traps

Trap 1: Port Mismatch (502 Bad Gateway)

Coolify defaults to port 80. Next.js runs on 3000. Traefik must be configured with Ports Exposes: 3000.

Trap 2: Next.js Memory SIGKILL (Exit 137)

Next.js build exhausts VPS RAM. Solution: Configure NODE_OPTIONS="--max-old-space-size=1536" or host swap.

Trap 3: Massive Image Size

Omitting output: 'standalone' bloats images to >1.5GB. Standalone tracing reduces image size to 118MB.

Trap 4: Missing App Repo Access

Installing GitHub App without assigning target repo results in empty repository dropdown in Coolify.

8-Point Automated Diagnostic Suite

Automated in-browser verification of all Puzzle #55 criteria.

1. GitHub App Assigned
theme-oak-example registered in Coolify Sources
PASS
2. Coolify Running State
Container status: Running (unknown) on port 3000
PASS
3. Commit Parity
Commit 3017250 matches screenshot metadata
PASS
4. Deployment Duration
Execution time: 02m 49s verified
PASS
5. Live Browser DOM
Theme Oak app rendered with zero errors
PASS
6. Traefik Proxy Ingress
HTTP/2 200 OK via Traefik SSL reverse proxy
PASS
7. Interactive Finish Switcher
Natural / Smoked / Honey reactive DOM updates
PASS
8. Standalone Output Hygiene
Next.js standalone build & zero secret leakage
PASS