#Instalasi Docker (Caddy eksternal)

Dalam mode ini, kontainer aplikasi NocoBase dan kontainer Caddy berjalan terpisah. Anda bisa mulai dari Instalasi Docker (Nginx bawaan), lalu mengganti pintu masuk ke kontainer Caddy eksternal.

#Kapan menggunakan mode ini

• Anda ingin memisahkan deployment NocoBase dan web server
• Anda ingin menyederhanakan konfigurasi reverse proxy dan HTTPS dengan Caddy
• Anda ingin hanya mengekspos kontainer proxy ke jaringan publik

#Contoh docker-compose.yml

Jika Anda membutuhkan image full, ganti latest-no-nginx dengan latest-full-no-nginx.

Mapping 13000:80 hanya untuk memudahkan pengujian lokal, agar tidak langsung memakai port standar host. Di produksi, biasanya jangan terus memakai 13000:80; biarkan kontainer Caddy eksternal langsung memetakan port host 80 dan 443.

networks:
  nocobase:
    driver: bridge

services:
  app:
    image: nocobase/nocobase:latest-no-nginx
    restart: always
    depends_on:
      - postgres
    networks:
      - nocobase
    environment:
      - APP_KEY=your-secret-key
      - DB_DIALECT=postgres
      - DB_HOST=postgres
      - DB_PORT=5432
      - DB_DATABASE=nocobase
      - DB_USER=nocobase
      - DB_PASSWORD=nocobase
      - TZ=Etc/UTC
      - NOCOBASE_EXTRACT_CLIENT_ASSETS=true
      - NOCOBASE_PROXY_PROVIDER=caddy
      - NOCOBASE_PROXY_STORAGE_PATH=/app/nocobase/storage
      - NOCOBASE_PROXY_UPSTREAM_HOST=app
    volumes:
      - ./storage:/app/nocobase/storage

  caddy:
    image: caddy:2
    restart: always
    depends_on:
      - app
    networks:
      - nocobase
    volumes:
      - ./storage:/app/nocobase/storage
    command: >
      /bin/sh -c '
        while [ ! -f /app/nocobase/storage/.nocobase/proxy/caddy/nocobase.caddy ]; do
          echo "waiting for nocobase.caddy..."
          sleep 1
        done
        ln -sf /app/nocobase/storage/.nocobase/proxy/caddy/nocobase.caddy /etc/caddy/Caddyfile
        caddy run --config /etc/caddy/Caddyfile --adapter caddyfile
      '
    ports:
      # Ini hanya contoh untuk pengujian lokal.
      - "13000:80"
      # Di produksi, biasanya ubah menjadi:
      # - "80:80"
      # - "443:443"

  postgres:
    image: postgres:16
    restart: always
    command: postgres -c wal_level=logical
    environment:
      POSTGRES_USER: nocobase
      POSTGRES_DB: nocobase
      POSTGRES_PASSWORD: nocobase
    volumes:
      - ./storage/db/postgres:/var/lib/postgresql/data
    networks:
      - nocobase

#Poin penting

• NOCOBASE_EXTRACT_CLIENT_ASSETS=true mengekstrak aset klien dan membuat konfigurasi proxy
• NOCOBASE_PROXY_PROVIDER=caddy menandakan bahwa konfigurasi Caddy harus dibuat
• NOCOBASE_PROXY_UPSTREAM_HOST=app memungkinkan kontainer Caddy mengakses layanan app melalui jaringan Compose
• ./storage harus dimount ke app dan caddy agar konfigurasi proxy, aset statis, dan file unggahan bisa dipakai bersama
• Kontainer caddy perlu menunggu sampai nocobase.caddy dibuat, lalu menautkannya ke /etc/caddy/Caddyfile dengan ln -sf
• Konfigurasi yang dibuat otomatis meneruskan rute /files/ di bawah APP_PUBLIC_PATH dan rute /files/ di root ke NocoBase untuk pratinjau dan unduhan file yang memerlukan autentikasi
• Ekspos hanya port kontainer Caddy ke host. Untuk pengujian, Anda bisa mulai dengan 13000:80; di produksi, biasanya langsung ekspos port host 80 dan 443, sementara layanan app tidak perlu membuka port ke host

#Jika menggunakan Caddy lokal di host

Jika Caddy Anda terpasang langsung di host dan tidak berjalan di dalam kontainer Docker, sebaiknya gunakan docker-compose.yml terpisah. Dalam mode ini, layanan app perlu membuka port ke host, dan variabel proxy harus memakai nilai dari sudut pandang host.

Anda bisa memakai docker-compose.yml seperti ini:

networks:
  nocobase:
    driver: bridge

services:
  app:
    image: nocobase/nocobase:latest-no-nginx
    restart: always
    depends_on:
      - postgres
    networks:
      - nocobase
    environment:
      - APP_KEY=your-secret-key
      - DB_DIALECT=postgres
      - DB_HOST=postgres
      - DB_PORT=5432
      - DB_DATABASE=nocobase
      - DB_USER=nocobase
      - DB_PASSWORD=nocobase
      - TZ=Etc/UTC
      - NOCOBASE_EXTRACT_CLIENT_ASSETS=true
      - NOCOBASE_PROXY_PROVIDER=caddy
      - NOCOBASE_PROXY_STORAGE_PATH=/path/to/your-project/storage
      - NOCOBASE_PROXY_UPSTREAM_HOST=127.0.0.1
      - NOCOBASE_PROXY_UPSTREAM_PORT=13000
    volumes:
      - ./storage:/app/nocobase/storage
    ports:
      - "13000:13000"

  postgres:
    image: postgres:16
    restart: always
    command: postgres -c wal_level=logical
    environment:
      POSTGRES_USER: nocobase
      POSTGRES_DB: nocobase
      POSTGRES_PASSWORD: nocobase
    volumes:
      - ./storage/db/postgres:/var/lib/postgresql/data
    networks:
      - nocobase

Dalam varian ini:

• NOCOBASE_PROXY_STORAGE_PATH harus berupa path absolut direktori storage di host
• NOCOBASE_PROXY_UPSTREAM_HOST harus 127.0.0.1
• Layanan app perlu mempertahankan ports, supaya Caddy lokal bisa mengakses aplikasi melalui 127.0.0.1:13000

Setelah kontainer app berjalan, tunggu file konfigurasi dibuat lalu tautkan ke path konfigurasi Caddy lokal:

while [ ! -f ./storage/.nocobase/proxy/caddy/nocobase.caddy ]; do
  echo "waiting for nocobase.caddy..."
  sleep 1
done

sudo ln -sf "$(pwd)/storage/.nocobase/proxy/caddy/nocobase.caddy" /etc/caddy/Caddyfile
sudo caddy validate --config /etc/caddy/Caddyfile --adapter caddyfile
sudo systemctl reload caddy

Jika Caddy lokal Anda tidak menggunakan /etc/caddy/Caddyfile, ganti target link dengan path konfigurasi Anda sendiri. Biasanya lebih aman membiarkan nocobase.caddy tetap sebagai file masuk utama daripada menyalin isinya secara manual.

Jika Anda mengelola Caddy sendiri dan tidak menggunakan konfigurasi yang dibuat otomatis, pastikan /files/* serta rute terkait di bawah APP_PUBLIC_PATH diteruskan ke NocoBase sebelum rule fallback SPA. Lihat Reverse proxy Caddy untuk contoh lengkap.

#Tautan terkait

• Instalasi Docker (Nginx bawaan) — Mulai dari deployment satu kontainer
• Proxy sumber daya statis Caddy — Pelajari lebih lanjut tentang konfigurasi Caddy yang dihasilkan