Coolify

Coolify Deployment Knowledge Base

Dockerfile (Next.js)

FROM node:20-alpine AS base

FROM base AS deps
WORKDIR /app
COPY package*.json ./
RUN npm ci

FROM base AS builder
WORKDIR /app
COPY --from=deps /app/node_modules ./node_modules
COPY . .
ENV NEXT_TELEMETRY_DISABLED=1
RUN npm run build

FROM base AS runner
WORKDIR /app
ENV NODE_ENV=production

RUN addgroup --system --gid 1001 nodejs
RUN adduser --system --uid 1001 nextjs

COPY --from=builder /app/public ./public
COPY --from=builder /app/.next/standalone ./
COPY --from=builder /app/.next/static ./.next/static

USER nextjs
EXPOSE 3000

HEALTHCHECK --interval=30s --timeout=3s \
  CMD wget --spider http://localhost:3000/api/health || exit 1

CMD ["node", "server.js"]

next.config.js

module.exports = {
  output: 'standalone',
};

Health Check Endpoint

// app/api/health/route.ts
import { NextResponse } from 'next/server';

export async function GET() {
  return NextResponse.json({
    status: 'ok',
    timestamp: new Date().toISOString(),
  });
}

.dockerignore

node_modules
.next
.git
*.md
.env*
!.env.example

GitHub Actions Deploy

name: Deploy

on:
  push:
    branches: [main]

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      
      - name: Deploy to Coolify
        run: |
          curl -X POST \
            -H "Authorization: Bearer ${{ secrets.COOLIFY_TOKEN }}" \
            "${{ secrets.COOLIFY_WEBHOOK }}"

Coolify Settings

Environment Variables

NODE_ENV=production
DATABASE_URL=
AUTH_SECRET=
NEXT_PUBLIC_API_URL=https://yourdomain.com

Health Check

• Path: /api/health
• Interval: 30s
• Timeout: 10s

SSL

• Provider: Let's Encrypt
• Auto-renewal: Enabled

Checklist

• Dockerfile multi-stage
• output: 'standalone' in next.config
• Health check endpoint
• .dockerignore configured
• Environment variables set
• SSL enabled
• GitHub webhook configured