Firecrawl self-hosted dulu hanya berarti satu hal: clone repo, jalankan Docker Compose, lalu jaga agar API, layanan Playwright, Redis, RabbitMQ, dan Postgres tetap hidup di mesin Anda. Pada 18 November 2026, Firecrawl merilis opsi kedua. Firecrawl Local adalah satu binary Rust yang melakukan scrape, crawl, dan map situs ke markdown serta melayani API v2 yang sama di localhost:3002, tanpa database, queue, atau container.

Coba Apidog hari ini

Jawaban singkat: pilih Firecrawl Local jika Anda ingin scrape, crawl, map, dan batch scrape di laptop atau di toolbelt agen tanpa infrastruktur apa pun. Pertahankan stack Docker self-hosted jika Anda membutuhkan job persisten, format json dan summary, ekstraksi LLM melalui model Anda sendiri, atau route search yang tidak pernah menyentuh Firecrawl Cloud.

Apa itu Firecrawl self-hosted, dan apa itu Firecrawl Local?

Firecrawl self-hosted adalah server Firecrawl lengkap dari apps/api, yang dijalankan di infrastruktur Anda sendiri dengan Docker Compose. Firecrawl Local adalah build terpisah yang lebih ringan di apps/local: satu binary yang mengambil dan membersihkan halaman di mesin Anda menggunakan kode pembersihan HTML yang sama, lalu menyerahkan search, halaman terblokir, dan Alexandria ke Firecrawl Cloud.

Keduanya berada di repositori GitHub Firecrawl, keduanya melayani API v2 di port 3002, dan keduanya open source di bawah AGPL-3.0. Firecrawl Local tidak menggantikan server. README Firecrawl Local menyatakannya secara langsung: panduan self-hosting "berada di apps/api dan tidak berubah oleh Firecrawl Local."

Baru mengenal Firecrawl? Mulailah dengan panduan web scraping Firecrawl kami.

Firecrawl Local vs Firecrawl self-hosted secara singkat

Berikut versi ringkasnya, disusun dari panduan self-hosting, halaman open source vs cloud, dan README Local, semuanya dibaca pada 19 November 2026.

Fitur Firecrawl self-hosted Firecrawl Local
Yang Anda jalankan Stack Docker Compose: api, playwright-service, redis, rabbitmq, nuq-postgres Satu binary, firecrawl-local
Instalasi git clone, tulis .env, docker compose up --build -d cargo install firecrawl-local
Prasyarat Git, Docker Engine, Compose v2 Rust dan compiler C; Chrome dan Node 22+ opsional
API v2 di port 3002 v2 di port 3002 (scrape, map, crawl, batch scrape, health)
Route search Termasuk dalam stack default Diteruskan ke Firecrawl Cloud
Format LLM (json, summary) Hubungkan penyedia yang kompatibel dengan OpenAI atau Ollama Dilewati dengan peringatan
Screenshot Memerlukan Fire-engine, tidak ada di stack default Berfungsi jika Chrome terpasang
actions browser Memerlukan Fire-engine Diabaikan
Penyimpanan job Queue berbasis Postgres Di memori, kedaluwarsa setelah 1 jam
Alexandria Tidak tercantum dalam tabel fitur self-host Melalui Firecrawl Cloud dengan akun gratis
Setup MCP Arahkan server MCP ke URL Anda firecrawl-local init menulis konfigurasinya
Lisensi AGPL-3.0 AGPL-3.0

Local menukar kedalaman dengan keringanan: ia mempertahankan route yang paling sering dipanggil agen dan membuang hal-hal yang membutuhkan queue, model, atau kumpulan browser.

Apa yang berubah: dari lima layanan menjadi satu binary

Jalur self-hosted menetapkan rilis v2.11.162 dalam panduannya. Anda clone repo, tulis .env kecil dengan kredensial Postgres dan USE_DB_AUTHENTICATION=false, lalu build dan jalankan stack:

git clone https://github.com/firecrawl/firecrawl.git cd firecrawl git checkout v2.11.162 docker compose up --build -d docker compose ps --all 

File compose tersebut menjalankan container api (yang juga menjalankan worker), playwright-service untuk rendering, redis, rabbitmq, dan nuq-postgres untuk queue job. File compose membatasi API pada 4 CPU dan 8 GB memori serta layanan Playwright pada 2 CPU dan 4 GB, dan panduan mencatat bahwa batasan tersebut "bukan persyaratan minimum yang terverifikasi."

Arsitektur berdampingan: Firecrawl self-hosted menjalankan api dengan worker, playwright-service, redis, rabbitmq, dan nuq-postgres di bawah docker compose up, sementara Firecrawl Local adalah satu binary Rust dengan Chrome opsional dan serah-terima putus-putus ke Firecrawl Cloud untuk search, halaman terblokir, dan Alexandria; keduanya mengekspos API v2 di localhost:3002

Firecrawl Local menciutkan semua itu menjadi satu perintah:

cargo install firecrawl-local firecrawl-local scrape https://example.com --markdown firecrawl-local crawl https://docs.firecrawl.dev --limit 50 --out ./pages firecrawl-local map https://firecrawl.dev firecrawl-local serve 

Tidak ada .env dan tidak ada container. Halaman JavaScript dirender di Chrome atau Chromium yang sudah Anda miliki; tanpa itu, halaman statis tetap berfungsi dan sisanya mengembalikan peringatan.

Perintah search, find-tools, data, dan login menjangkau Firecrawl Cloud. firecrawl-local login menggunakan kembali kredensial CLI hosted dari panduan instalasi Firecrawl CLI kami.

Cakupan endpoint: apa yang dilayani masing-masing

Di sinilah migrasi sering rusak, jadi periksa ini sebelum Anda mengalihkan base URL SDK.

Firecrawl Local melayani route berikut di mesin Anda:

  • POST /v2/scrape melakukan scrape satu URL
  • POST /v2/map mendaftar URL sebuah situs
  • POST /v2/crawl, plus GET dan DELETE /v2/crawl/{id}
  • POST /v2/batch/scrape, plus GET dan DELETE /v2/batch/scrape/{id}
  • GET /health

Setiap route /v2 lainnya, seperti /v2/search, diteruskan ke Firecrawl Cloud kecuali FIRECRAWL_CLOUD menentukan sebaliknya. Route v0 dan v1 tidak dilayani sama sekali.

Firecrawl self-hosted mencakup scrape, crawl, map, dan search inti dalam stack default, menurut halaman open source vs cloud. Ekstraksi berbasis LLM membutuhkan penyedia yang Anda hubungkan. Agent, Browser, Interact, dan dashboard tidak disertakan.

Dua jebakan praktis:

  1. Pemeriksaan health berbeda. Panduan self-hosting memeriksa kesiapan di /v0/health/readiness. Firecrawl Local tidak melayani v0, jadi gunakan GET /health sebagai gantinya. Perbarui monitor dan healthcheck compose Anda.
  2. Search berubah di mana ia berjalan. Pada stack Docker, search tetap di infrastruktur Anda. Pada Local, ia pergi ke Firecrawl Cloud, dan search tanpa kunci dibatasi rate-nya. Setel FIRECRAWL_CLOUD=off jika tidak boleh ada apa pun yang keluar dari mesin; search kemudian berhenti berfungsi.

Kecepatan dan memori: baca klaimnya dengan cermat

Postingan peluncuran Firecrawl di X menyebut Firecrawl Local adalah "primitive scrape berbasis Rust yang 37x lebih cepat (dibanding self-hosted)" dan menggunakan "memori 230x lebih sedikit (11 MB saat idle)." Postingan tersebut menarik sekitar 324K tayangan dan 3,2K like pada hari pertamanya.

Anggap angka-angka itu sebagai klaim Firecrawl. README tidak menerbitkan metode benchmark, kumpulan halaman, maupun perangkat keras, jadi kami tidak bisa memberi tahu Anda apa yang diukur oleh "37x". Yang didukung arsitektur adalah arahnya: satu proses idle seharusnya jauh lebih ringan daripada lima container yang batas compose-nya saja mengizinkan hingga 12 GB antara layanan API dan Playwright.

Jika kecepatan menentukan pilihan Anda, ukurlah pada URL Anda sendiri. Jalankan scrape yang sama terhadap kedua server, bandingkan waktu, dan periksa apakah markdown-nya cocok. Bagian tentang Apidog CLI di bawah menunjukkan satu cara untuk menjadikannya uji yang dapat diulang.

Keamanan, serah-terima ke cloud, dan alur data

Self-hosting memberi Anda kendali penuh dan tanggung jawab penuh. Quickstart dalam panduan menonaktifkan autentikasi dan memperingatkan bahwa itu "bukan arsitektur produksi," jadi volume persisten, auth, TLS, dan monitoring menjadi tanggung jawab Anda.

Firecrawl Local hadir dengan default yang lebih ketat untuk satu mesin:

  • serve mengikat ke 127.0.0.1 dan menolak localhost serta alamat privat kecuali Anda meneruskan --allow-private.
  • Alamat link-local dan metadata cloud diblokir di setiap mode, termasuk setelah redirect.
  • scrape, crawl, dan mcp menerima --public-only, yang direkomendasikan README ketika agen menjelajahi situs yang tidak Anda percayai.
  • Crawl menghormati robots.txt.

Tukar-tambahnya adalah serah-terima ke cloud. Dengan FIRECRAWL_CLOUD=auto default, search, halaman yang memblokir mesin Anda, dan Alexandria pergi ke Firecrawl Cloud. Hasil tersebut membawa "source": "firecrawl-cloud". Setel FIRECRAWL_CLOUD=search untuk hanya mengizinkan search, atau off untuk tidak mengirim apa pun.

Alexandria, katalog penyedia data Firecrawl, membutuhkan akun gratis dan firecrawl-local login. Penjelasan Firecrawl Alexandria kami membahas apa yang dikembalikannya.

Mana yang harus Anda pilih?

Pilih Firecrawl Local jika:

  • Anda ingin agen AI melakukan scrape dan crawl di laptop Anda. firecrawl-local init menambahkan server MCP ke Claude Code, Claude Desktop, Cursor, Windsurf, Gemini CLI, dan Codex, dengan mencadangkan setiap konfigurasi terlebih dahulu.
  • Anda menjalankan job singkat yang selesai dalam satu jam.
  • Anda hanya membutuhkan markdown, HTML, HTML mentah, dan tautan.
  • Anda tidak ingin mengelola Postgres, Redis, dan RabbitMQ sendiri.

Pertahankan Firecrawl self-hosted jika:

  • Job crawl harus bertahan setelah restart atau berjalan lebih dari satu jam.
  • Anda membutuhkan output json atau summary melalui model Anda sendiri.
  • Search harus tetap di infrastruktur Anda.
  • Beberapa layanan atau pengguna berbagi satu backend scraping di balik auth Anda.

Banyak tim akan menjalankan keduanya: Local di laptop dan di agen, stack Docker atau Firecrawl Cloud di produksi. Untuk setup agen yang hanya membutuhkan search, rangkuman kami tentang web search open source untuk Claude mencantumkan opsi lain, dan panduan Firecrawl MCP dan llms.txt membahas server MCP hosted.

Memigrasikan kode SDK dari self-hosted ke Local

Kode SDK Anda tidak berubah, hanya URL-nya: setel API URL SDK Python atau Node ke http://localhost:3002, tanpa API key untuk route lokal. Sebelum mengalihkannya, pastikan kode Anda tidak memanggil v0 atau v1, tidak pernah meminta json, summary, atau actions, dan tidak pernah melakukan polling ID crawl yang lebih tua dari satu jam atau melintasi restart serve.

Biarkan coding agent Anda menjalankan uji paritas dengan Apidog CLI

Mengganti backend adalah pertanyaan kontrak: apakah /v2/scrape di Local mengembalikan bentuk yang sama dengan yang sudah di-parse kode Anda? Jangan diff respons secara manual. Jalankan kedua server berdampingan (Docker di 3002, firecrawl-local serve --port 3012) dan biarkan coding agent Anda menguji keduanya dengan Apidog CLI.

Siapkan sekali:

npm install -g apidog-cli@latest apidog auth login --with-token <YOUR_TOKEN> apidog skill install 

Lalu beri agen Anda satu prompt:

Self-hosted Firecrawl berjalan di http://localhost:3002 dan Firecrawl Local di http://localhost:3012. Di project Apidog <id>, buat dua environment, "self-hosted" dan "local". Tambahkan test case untuk POST /v2/scrape pada https://example.com (assert 200, success: true, data.markdown tidak kosong) dan POST /v2/map (assert 200 dan array links tidak kosong). Jalankan test case tersebut terhadap kedua environment dan beri tahu saya setiap assertion yang berbeda. 

Uji paritas: coding agent menjalankan test case Apidog yang sama terhadap stack self-hosted di port 3002 dan Firecrawl Local di port 3012, lalu membandingkan dua laporan pada status, success, dan markdown

Agen membaca skema payload, memvalidasinya, dan menjalankan test case yang sama dua kali:

firecrawl-local serve --port 3012 & apidog environment create self-hosted --project <id> --base-url http://localhost:3002 apidog environment create local --project <id> --base-url http://localhost:3012 apidog cli-schema get test-case-create apidog cli-schema validate test-case-create --file scrape-case.json apidog test-case create --project <id> --file scrape-case.json apidog run --test-case <caseId> --project <id> -e <selfHostedEnvId> -r cli,json --out-file self-hosted apidog run --test-case <caseId> --project <id> -e <localEnvId> -r cli,json --out-file local 

Apidog CLI mengirim permintaan dari mesin Anda, sehingga kedua port localhost dapat dijangkau. Ganti -r cli,json dengan -r junit dan pemeriksaan yang sama berjalan di CI pada setiap upgrade Firecrawl; panduan Apidog CLI CI/CD kami menunjukkan setup-nya, dan Apidog CLI di Claude Code membahas sisi agen. Paket Free Apidog mencakup tim hingga 4 pengguna.

FAQ

Apakah Firecrawl Local menggantikan Firecrawl self-hosted? Tidak. Ini adalah build terpisah di apps/local. Server lengkap di apps/api dan panduan self-hosting-nya tidak berubah, dan Anda tetap membutuhkannya untuk job persisten dan format LLM.

Apakah Firecrawl Local benar-benar 37x lebih cepat daripada Firecrawl self-hosted? Itu klaim Firecrawl dari postingan peluncurannya, bersama dengan memori 230x lebih sedikit dan 11 MB saat idle. README tidak menerbitkan metode benchmark, jadi ujilah pada URL Anda sendiri.

Apakah Firecrawl Local berfungsi tanpa cloud? Ya. Setel FIRECRAWL_CLOUD=off dan scrape, crawl, serta map tetap di mesin Anda. Search, fallback halaman terblokir, dan Alexandria berhenti berfungsi.

Apakah Firecrawl self-hosted gratis? Kodenya gratis di bawah AGPL-3.0, baik untuk server maupun Local. Anda membayar mesin dan waktu untuk menjalankan Postgres, Redis, dan RabbitMQ sendiri.

Mana yang harus digunakan agen AI? Firecrawl Local, dalam banyak kasus. firecrawl-local init mendaftarkannya sebagai server MCP di enam tool agen, dan --public-only mencegah agen menjangkau jaringan privat Anda.