# Build Next.js lambat atau kehabisan memori di GitHub Actions: cache, memori, ukuran runner

> Build Next.js di GitHub Actions lambat saat .next/cache tidak terbawa ke run berikutnya, dan kehabisan memori di ubuntu-latest 8 GB milik repositori privat begitu webpack, type checking, dan source map bertumpuk. Apa yang perlu di-cache, setelan Next.js mana yang memangkas memori, dan ukuran runner-nya: 16 GB seharga $79 per bulan atau 32 GB seharga $149 di Skipbox, tempat .next/cache tetap ada di antara job, menit tanpa batas.

Build Next.js di GitHub Actions lambat karena satu alasan dan kehabisan memori karena alasan lain. Build lambat saat `.next/cache` tidak terbawa ke run berikutnya: Next.js memakai ulang cache itu di antara build, job yang dihosting GitHub dimulai di VM baru, dan tanpa step cache setiap build dimulai dingin (log-nya menulis `No Cache Detected`). Build kehabisan memori karena `ubuntu-latest` di repositori privat punya 8 GB, dan kompilasi webpack, type check, serta source map aplikasi yang besar bisa melewatinya. Perbaiki yang pertama dengan `actions/cache` pada `.next/cache`. Untuk yang kedua, setelan memori Next.js lebih dulu (`experimental.webpackMemoryOptimizations`, tanpa source map produksi); lalu mesin dengan memori lebih besar: 16 GB atau 32 GB.

Skipbox memberi build memori itu dengan harga tetap: 16 GB dan 8 vCPU di `runs-on: skipbox-8x16` seharga $79 per bulan, 32 GB dan 16 vCPU di `skipbox-16x32` seharga $149. Di mesin khusus untuk Anda, `.next/cache` tetap ada untuk build berikutnya, cache paket tetap ada di disk, dan apa yang disimpan `actions/cache` dibaca secara lokal, dengan menit tanpa batas.

- `.next/cache` tetap ada di mesin khusus untuk Anda: build berikutnya memakai ulang kompilasi terakhirnya, tanpa step cache
- 16 GB seharga $79 per bulan atau 32 GB seharga $149, dibandingkan 8 GB di `ubuntu-latest` privat
- Cache paket tetap ada di mesin Anda, dan pemulihan cache membaca disknya alih-alih mengunduh

**GitHub Actions dengan harga tetap, menit tanpa batas** Skipbox menjalankan job GitHub Actions Anda di mesin khusus milik Anda sendiri: $39 per bulan, berapa pun menit yang Anda jalankan. Layer Docker dan cache dependensi tetap tersimpan di antara job, jadi job berikutnya langsung dimulai.

Runner 4 vCPU, 20.000 menit per bulan: GitHub $222 → Skipbox $39. Anda hemat $183 setiap bulan.

Pindah cukup dengan satu baris: `runs-on: skipbox`.

[Mulai uji coba gratis 7 hari](https://app.skipbox.dev/sign-in?ref=g-nextjs-build-slow-out-of-memory-github-actions-id)

## Lambat: .next/cache dimulai kosong

Dari [panduan CI build caching](https://nextjs.org/docs/app/guides/ci-build-caching) Next.js: Next.js "saves a cache to `.next/cache` that is shared between builds", dan CI yang tidak menyimpannya di antara build menampilkan error `No Cache Detected`. Step GitHub Actions-nya:

```yaml
- uses: actions/cache@v4
  with:
    path: |
      ~/.npm
      ${{ github.workspace }}/.next/cache
    key: ${{ runner.os }}-nextjs-${{ hashFiles('**/package-lock.json') }}-${{ hashFiles('**/*.js', '**/*.jsx', '**/*.ts', '**/*.tsx') }}
    restore-keys: |
      ${{ runner.os }}-nextjs-${{ hashFiles('**/package-lock.json') }}-
```

Key-nya berubah di setiap perubahan source, jadi setiap run menyimpan entri baru, di dalam 10 GB per repositori milik GitHub. Di Turborepo, kecualikan `.next/cache` dari `outputs` task (`"!.next/cache/**"`), seperti di [panduan GitHub Actions Turborepo](https://turborepo.dev/docs/guides/ci-vendors/github-actions).

## Kehabisan memori: dua error yang berbeda

| Di log | Apa yang habis | Yang perlu dilakukan |
|---|---|---|
| `JavaScript heap out of memory` | Batas heap milik Node sendiri; mesinnya masih punya memori | Naikkan: `NODE_OPTIONS=--max-old-space-size=6144`, di bawah memori mesin |
| `Process completed with exit code 137` | Memori mesin: Linux menghentikan prosesnya | Pakai memori lebih sedikit, atau mesin dengan memori lebih besar |

Menaikkan heap melebihi memori mesin mengubah error pertama menjadi error kedua.

## Pakai memori lebih sedikit: setelan milik Next.js

Dari [panduan pemakaian memori](https://nextjs.org/docs/app/guides/memory-usage) Next.js:

- **`experimental.webpackMemoryOptimizations: true`** (v15.0.0 dan yang lebih baru) menurunkan puncak memori webpack, dengan kompilasi yang sedikit lebih lama.
- **Webpack build worker** menjalankan kompilasi di worker Node terpisah, yang menurunkan memori. Fitur ini aktif secara default sejak v14.1.0 kecuali Anda punya konfigurasi webpack kustom; jika punya, atur `experimental.webpackBuildWorker: true`.
- **Source map dimatikan:** `productionBrowserSourceMaps: false` dan `experimental.serverSourceMaps: false`. Jika build kehabisan memori saat "Generating static pages", tambahkan juga `enablePrerenderSourceMaps: false`.
- **Ukur:** `next build --experimental-debug-memory-usage` (v14.2.0 dan yang lebih baru) mencetak pemakaian heap sepanjang build, dan mengambil heap snapshot saat mendekati batas.
- **Type checking:** `typescript.ignoreBuildErrors: true` melewati type check dan memorinya, dan meloloskan error tipe ke dalam build. Next.js memperingatkan agar tidak memakainya kecuali ada step lain yang melakukan type check.

## Pakai mesin dengan memori lebih besar

| Runner | CPU dan memori | Siapa yang bisa memakainya |
|---|---|---|
| `ubuntu-latest` GitHub, repositori privat | 2 CPU, 8 GB | Semua orang |
| `ubuntu-latest` GitHub, repositori publik | 4 CPU, 16 GB | Repositori publik |
| Larger runner GitHub, 4 atau 8 core | 16 GB atau 32 GB | Organisasi GitHub Team dan Enterprise Cloud, per menit ([larger runners](https://docs.github.com/en/actions/concepts/runners/larger-runners)) |
| Skipbox `skipbox-8x16` | 8 vCPU, 16 GB | Organisasi dan akun pribadi, $79 per bulan |
| Skipbox `skipbox-16x32` | 16 vCPU, 32 GB | Organisasi dan akun pribadi, $149 per bulan |

Untuk 20.000 menit per bulan, runner 8-core GitHub berbiaya $422 dan Skipbox M $79; di 16 core, $822 dibandingkan $149 untuk L. Angka GitHub adalah setelah dikurangi kuota bawaan GitHub Team.

## Yang dilakukan Skipbox untuk build Next.js

Setiap paket datang dengan mesin khusus untuk akun Anda, yang disimpan di antara job:

- **Memori yang dibutuhkan build**, sesuai label: 16 GB di M, 32 GB di L. Sesuaikan heap-nya, misalnya `--max-old-space-size=12288` di M.
- **Cache paket tetap ada di disk:** `~/.npm`, store pnpm, `~/.cache` setiap tool, dan versi Node yang dipasang `setup-node`. `npm ci` membacanya alih-alih registry.
- **`.next/cache` tetap ada untuk job berikutnya.** Mesin menyimpan checkout Anda di antara job, termasuk `.next/cache` di dalamnya, sedalam apa pun monorepo menaruhnya (`apps/web/.next/cache`). `next build` berikutnya mulai dari situ, tanpa step cache dan tanpa `No Cache Detected`. Isi `.next` lainnya dan file lain yang tidak dilacak di checkout dibersihkan setelah setiap job.
- **Pemulihan `actions/cache` membaca mesin.** Apa yang disimpannya tetap berada di samping mesin, dengan ruang lebih besar dari 10 GB per repositori milik GitHub, dan pemulihannya berupa pembacaan lokal. Pertahankan step `.next/cache` untuk job yang berjalan di VM baru; di mesin khusus untuk Anda, pemulihan membiarkan cache yang disimpan apa adanya.
- **Core lebih banyak dengan harga tetap.** Kompilasi dan pembuatan halaman statis memakainya, dan menitnya tanpa batas.

| Label | Mesin | Paket |
|---|---|---|
| `skipbox` | 4 vCPU · 16 GB | S, $39 per bulan |
| `skipbox-8x16` | 8 vCPU · 16 GB | M, $79 per bulan |
| `skipbox-16x32` | 16 vCPU · 32 GB | L, $149 per bulan |

## Pindah cukup satu baris

```yaml
jobs:
  build:
    runs-on: skipbox-8x16 # was ubuntu-latest
    env:
      NODE_OPTIONS: --max-old-space-size=12288
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 22
          cache: npm
      - uses: actions/cache@v4
        with:
          path: ${{ github.workspace }}/.next/cache
          key: ${{ runner.os }}-nextjs-${{ hashFiles('**/package-lock.json') }}-${{ hashFiles('**/*.js', '**/*.jsx', '**/*.ts', '**/*.tsx') }}
          restore-keys: |
            ${{ runner.os }}-nextjs-${{ hashFiles('**/package-lock.json') }}-
      - run: npm ci
      - run: npx next build
```

`skipbox-8x16` berjalan di paket M; uji coba menjalankan `runs-on: skipbox`.

1. Masuk ke Skipbox dengan GitHub.
2. Instal aplikasi GitHub Skipbox dan pilih repositorinya.
3. Ubah `runs-on`, lalu push.

## Keamanan

- Mesinnya hanya milik akun Anda. Tidak ada job perusahaan lain yang berjalan di sana.
- Setelah setiap job, kredensial runner, proses, dan container dihapus, begitu juga kredensial git di checkout yang disimpan dan file-nya yang tidak dilacak, kecuali cache build seperti `.next/cache`. Bersih setiap job memberi setiap job mesin baru sebagai gantinya.
- Kode dari orang tanpa akses tulis (misalnya pull request dari fork) berjalan di VM baru yang bisa membaca cache Anda tetapi tidak bisa mengubahnya.

Detailnya ada di [cara job diisolasi](https://docs.skipbox.dev/id/isolation).

## Coba di build Next.js Anda

Uji cobanya gratis selama 7 hari atau 3.000 menit job, mana yang lebih dulu tercapai, tanpa kartu. Uji coba menjalankan `runs-on: skipbox`, dengan 16 GB, 2× memori `ubuntu-latest` di repositori privat: coba cache dan memorinya di sana, lalu pindahkan build yang butuh lebih ke paket L (`skipbox-16x32`, 32 GB).

## FAQ

### Kenapa next build lambat di GitHub Actions?

Biasanya karena .next/cache dimulai kosong. Next.js menyimpan build cache ke .next/cache dan memakainya ulang di build berikutnya, tetapi job yang dihosting GitHub adalah VM baru, jadi tanpa step yang membawa .next/cache, setiap build dimulai dingin dan log-nya memperingatkan No Cache Detected. Tambahkan actions/cache untuk .next/cache dengan key dari lockfile dan file source Anda. Sisa waktunya adalah instalasi dan kompilasi di 2 CPU.

### Ukuran runner apa yang sebaiknya dipakai build Next.js di GitHub Actions?

Memori yang cukup untuk puncak build. ubuntu-latest di repositori privat punya 2 CPU dan 8 GB, dan build webpack, type check, serta source map aplikasi Next.js yang besar bisa melewatinya. Larger runner GitHub punya 16 GB di 4 core dan 32 GB di 8, hanya di GitHub Team atau Enterprise Cloud, per menit. Skipbox memberi 16 GB dengan 8 vCPU di runs-on: skipbox-8x16 seharga $79 per bulan, dan 32 GB dengan 16 vCPU di skipbox-16x32 seharga $149.

### Bagaimana memperbaiki JavaScript heap out of memory di build Next.js pada GitHub Actions?

Error itu adalah batas heap milik Node sendiri, bukan memori mesin. Naikkan dengan NODE_OPTIONS=--max-old-space-size=<MiB>, di bawah memori mesin. Jika job lalu berakhir dengan exit code 137, mesinnya sendiri yang kehabisan memori: pangkas memori build (experimental.webpackMemoryOptimizations, tanpa source map produksi) atau jalankan di mesin dengan memori lebih besar.

### Bagaimana mengurangi pemakaian memori build Next.js?

Dari panduan memori Next.js: coba experimental.webpackMemoryOptimizations (v15 dan yang lebih baru), biarkan webpack build worker aktif (default tanpa konfigurasi webpack kustom sejak v14.1.0), matikan productionBrowserSourceMaps dan experimental.serverSourceMaps, dan ukur dengan next build --experimental-debug-memory-usage. Melewati type checking dengan typescript.ignoreBuildErrors menghemat memori tetapi meloloskan error tipe, jadi lakukan hanya jika ada job CI lain yang melakukan type check.

### Apakah Skipbox menyimpan .next/cache di antara job?

Ya. Mesin khusus untuk Anda menyimpan checkout di antara job, termasuk .next/cache di dalamnya, di mana pun Next.js menaruhnya (apps/web/.next/cache di monorepo), jadi next build berikutnya mulai dari cache build sebelumnya tanpa step cache. Isi .next lainnya dan file lain yang tidak dilacak di checkout dibersihkan setelah setiap job. Cache npm atau pnpm, versi Node yang dipasang setup-node, dan layer Docker juga tetap ada di disk. Step actions/cache untuk .next/cache boleh tetap ada: job di VM baru, seperti pull request dari fork, memulihkan dari step itu, dan di mesin khusus untuk Anda pemulihan membiarkan cache yang disimpan apa adanya.

### Berapa biaya untuk mencobanya?

Gratis. Uji cobanya 7 hari atau 3.000 menit job, mana yang lebih dulu tercapai, tanpa kartu, di 4 vCPU dan 16 GB: 2× 8 GB milik ubuntu-latest di repositori privat, dan sama dengan larger runner 4-core GitHub. Coba caching dan memorinya di sana; untuk build yang butuh lebih, pilih paket L dan ubah label-nya menjadi skipbox-16x32 (32 GB).

Diperbarui 2026-11-19 · https://skipbox.dev/id/guides/nextjs-build-slow-out-of-memory-github-actions
