Self-Host Next.js: Output Standalone, Docker, dan Env Var

  output: "standalone" as const, // self-hosted Docker deploy — trims node_modules to only what server.js needs

Satu baris mengaktifkan fiturnya. Semua isi pelajaran ini mengikutinya: build kini menulis folder standalone dengan server.js sendiri, dan Dockerfile menyalin folder itu, bukan seluruh proyek.

COPY --from=builder /app/public ./public
COPY --from=builder --chown=nextjs:nodejs /app/.next/standalone ./
COPY --from=builder --chown=nextjs:nodejs /app/.next/static ./.next/static

USER nextjs
EXPOSE 3000
CMD ["node", "server.js"]

Stage runner menyalin tiga hal: public, folder standalone, dan .next/static ke path yang diharapkan server.js. Flag chown memberi user non-root kepemilikan atas file yang dijalankannya. Proses lalu berjalan sebagai user non-root dan dimulai dengan node server.js, bukan next start.

ENV NODE_ENV=production
ENV NEXT_TELEMETRY_DISABLED=1
ENV PORT=3000
ENV HOSTNAME=0.0.0.0

PORT dan HOSTNAME adalah dua variabel yang disebut dokumentasi Next.js untuk server standalone. Dokumentasi menampilkan HOSTNAME 0.0.0.0 di contohnya sendiri. Compose kemudian mempublikasikan port container hanya di alamat loopback, jadi reverse proxy adalah pintu masuknya.

function getGroqClient(): Groq {
  if (!groq) {
    const apiKey = process.env.GROQ_API_KEY;
    if (!apiKey) {
      throw new Error("GROQ_API_KEY environment variable is missing");
    }
    groq = new Groq({ apiKey });
  }
  return groq;

Secret khusus server, dibaca tanpa prefix NEXT_PUBLIC di dalam fungsi yang berjalan saat request ditangani, dan gagal dengan jelas bila tidak ada. Ia tidak pernah masuk bundle browser, dan container menerima nilainya saat dijalankan, bukan saat image dibuild.

    healthcheck:
      test:
        [
          "CMD",
          "wget",
          "--no-verbose",
          "--tries=1",
          "--spider",
          "http://127.0.0.1:3000/robots.txt",
        ]
      interval: 30s
      timeout: 5s
      retries: 3
      start_period: 20s

Pengecekan berjalan di dalam container, jadi menargetkan port internal. Ia meminta robots.txt, route murah yang sudah ada dan tidak menyentuh database, bukan endpoint baru. Start period memberi server.js waktu untuk booting sebelum kegagalan dihitung, dan tiga kegagalan berturut-turut menandai container tidak sehat.

  cacheMaxMemorySize: 16 * 1024 * 1024,

Cache memori default adalah 50 MB, seperti dinyatakan panduan self-hosting. Situs ini menurunkannya, karena hampir setiap route diprerender saat build dan dibaca dari disk, dan server berbagi mesin kecil. Setel hanya setelah Anda mengukur memori.