Firecrawl selbst zu hosten bedeutete früher eines: Repo klonen, Docker Compose starten und auf dem eigenen Rechner eine API, einen Playwright-Dienst, Redis, RabbitMQ und Postgres am Laufen halten. Am 18. November 2026 hat Firecrawl eine zweite Option veröffentlicht. Firecrawl Local ist ein einzelnes Rust-Binary, das Websites zu Markdown scrapt, crawlt und mappt und dieselbe v2-API auf localhost:3002 bedient – ganz ohne Datenbank, Queue oder Container.

Probiere Apidog heute aus

Kurzantwort: Wähle Firecrawl Local, wenn du Scrape, Crawl, Map und Batch-Scrape auf einem Laptop oder in der Toolbox eines Agenten ohne jegliche Infrastruktur brauchst. Behalte den selbst gehosteten Docker-Stack, wenn du persistente Jobs, die Formate json und summary, LLM-Extraktion über dein eigenes Modell oder eine Suchroute brauchst, die niemals Firecrawl Cloud berührt.

Was ist selbst gehostetes Firecrawl, und was ist Firecrawl Local?

Selbst gehostetes Firecrawl ist der vollständige Firecrawl-Server aus apps/api, der auf deiner eigenen Infrastruktur mit Docker Compose läuft. Firecrawl Local ist ein separater, leichterer Build in apps/local: ein einzelnes Binary, das Seiten auf deinem Rechner mit demselben HTML-Cleaning-Code abruft und bereinigt und Suche, blockierte Seiten und Alexandria an Firecrawl Cloud übergibt.

Beide liegen im Firecrawl-GitHub-Repository, beide bedienen die v2-API auf Port 3002, und beide sind Open Source unter AGPL-3.0. Firecrawl Local ersetzt den Server nicht. Die Firecrawl-Local-README sagt es direkt: Die Self-Hosting-Anleitung „liegt in apps/api und wird durch Firecrawl Local nicht verändert."

Neu bei Firecrawl? Beginne mit unserem Firecrawl-Web-Scraping-Leitfaden.

Firecrawl Local vs. selbst gehostetes Firecrawl auf einen Blick

Hier die Kurzversion, zusammengestellt aus der Self-Hosting-Anleitung, der Seite Open Source vs. Cloud und der Local-README, alle gelesen am 19. November 2026.

Selbst gehostetes Firecrawl Firecrawl Local
Was du betreibst Docker-Compose-Stack: api, playwright-service, redis, rabbitmq, nuq-postgres Ein einzelnes Binary, firecrawl-local
Installation git clone, .env schreiben, docker compose up --build -d cargo install firecrawl-local
Voraussetzungen Git, Docker Engine, Compose v2 Rust und ein C-Compiler; Chrome und Node 22+ optional
API v2 auf Port 3002 v2 auf Port 3002 (Scrape, Map, Crawl, Batch-Scrape, Health)
Suchroute Im Standard-Stack enthalten Wird an Firecrawl Cloud weitergeleitet
LLM-Formate (json, summary) Verbindung zu einem OpenAI-kompatiblen Anbieter oder Ollama herstellen Wird mit einer Warnung übersprungen
Screenshots Benötigen Fire-engine, nicht im Standard-Stack Funktionieren, wenn Chrome installiert ist
Browser-actions Benötigen Fire-engine Werden ignoriert
Job-Speicherung Postgres-gestützte Queue Im Speicher, läuft nach 1 Stunde ab
Alexandria Nicht in der Self-Host-Feature-Tabelle aufgeführt Über Firecrawl Cloud mit einem kostenlosen Konto
MCP-Einrichtung MCP-Server auf deine URL zeigen lassen firecrawl-local init schreibt die Konfiguration
Lizenz AGPL-3.0 AGPL-3.0

Local tauscht Tiefe gegen Gewicht: Es behält die Routen, die Agenten am häufigsten aufrufen, und lässt weg, was eine Queue, ein Modell oder eine Browser-Farm benötigt.

Was sich geändert hat: von fünf Diensten zu einem Binary

Der Self-Hosting-Pfad pinnt in seiner Anleitung Release v2.11.162. Du klonst das Repo, schreibst eine kleine .env mit Postgres-Zugangsdaten und USE_DB_AUTHENTICATION=false und baust dann den Stack und startest ihn:

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

Diese Compose-Datei startet einen api-Container (der auch die Worker ausführt), einen playwright-service für das Rendering, redis, rabbitmq und nuq-postgres für die Job-Queue. Die Compose-Datei begrenzt die API auf 4 CPUs und 8 GB Arbeitsspeicher und den Playwright-Dienst auf 2 CPUs und 4 GB, und die Anleitung merkt an, dass diese Limits „keine verifizierten Mindestanforderungen" sind.

Architektur im Vergleich: Selbst gehostetes Firecrawl führt api mit Workern, playwright-service, redis, rabbitmq und nuq-postgres unter docker compose up aus, während Firecrawl Local ein einzelnes Rust-Binary mit optionalem Chrome und einer punktierten Übergabe an Firecrawl Cloud für Suche, blockierte Seiten und Alexandria ist; beide stellen die v2-API auf localhost:3002 bereit

Firecrawl Local reduziert das auf einen einzigen Befehl:

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 

Es gibt keine .env und keine Container. JavaScript-Seiten werden in dem Chrome oder Chromium gerendert, das du bereits hast; ohne eines funktionieren statische Seiten weiterhin, und der Rest liefert eine Warnung.

Die Befehle search, find-tools, data und login erreichen Firecrawl Cloud. firecrawl-local login nutzt die Zugangsdaten der gehosteten CLI aus unserem Firecrawl-CLI-Installationsleitfaden.

Endpoint-Abdeckung: Was jeder von beiden bedient

Hier brechen Migrationen, also prüfe das, bevor du die Basis-URL eines SDK umstellst.

Firecrawl Local bedient diese Routen auf deinem Rechner:

  • POST /v2/scrape scrapt eine URL
  • POST /v2/map listet die URLs einer Website auf
  • POST /v2/crawl, plus GET und DELETE /v2/crawl/{id}
  • POST /v2/batch/scrape, plus GET und DELETE /v2/batch/scrape/{id}
  • GET /health

Jede andere /v2-Route, etwa /v2/search, wird an Firecrawl Cloud weitergeleitet, sofern FIRECRAWL_CLOUD nichts anderes sagt. Die v0- und v1-Routen werden überhaupt nicht bedient.

Selbst gehostetes Firecrawl deckt in seinem Standard-Stack das Kern-Scrape, Crawl, Map und Search ab, laut der Seite Open Source vs. Cloud. LLM-gestützte Extraktion benötigt einen Anbieter, den du verbindest. Agent, Browser, Interact und das Dashboard sind nicht enthalten.

Zwei praktische Stolperfallen:

  1. Health-Checks unterscheiden sich. Die Self-Hosting-Anleitung prüft die Bereitschaft unter /v0/health/readiness. Firecrawl Local bedient v0 nicht, verwende stattdessen GET /health. Aktualisiere deine Monitore und Compose-Healthchecks.
  2. Search läuft an anderer Stelle. Im Docker-Stack bleibt die Suche auf deiner Infrastruktur. Bei Local geht sie an Firecrawl Cloud, und schlüssellose Suche ist ratenbegrenzt. Setze FIRECRAWL_CLOUD=off, wenn nichts den Rechner verlassen darf; die Suche funktioniert dann nicht mehr.

Geschwindigkeit und Speicher: Lies die Aussagen genau

Firecrawls Launch-Post auf X sagt, Firecrawl Local sei ein „37-mal schnellerer Rust-basierter Scrape-Primitive (im Vergleich zu selbst gehostet)" und verbrauche „230-mal weniger Speicher (11 MB im Leerlauf)." Der Post erreichte an seinem ersten Tag etwa 324K Aufrufe und 3,2K Likes.

Behandle diese Zahlen als Behauptungen von Firecrawl. Die README veröffentlicht weder eine Benchmark-Methode noch einen Seitensatz oder eine Hardware, sodass wir dir nicht sagen können, was „37x" gemessen hat. Was die Architektur jedoch stützt, ist die Richtung: Ein einzelner Leerlaufprozess sollte deutlich leichter wiegen als fünf Container, deren Compose-Limits allein zwischen API- und Playwright-Diensten bis zu 12 GB zulassen.

Wenn Geschwindigkeit deine Wahl entscheidet, miss sie an deinen eigenen URLs. Führe denselben Scrape gegen beide Server aus, vergleiche die Timings und prüfe, ob das Markdown übereinstimmt. Der Abschnitt zur Apidog CLI weiter unten zeigt einen Weg, daraus einen reproduzierbaren Test zu machen.

Sicherheit, Cloud-Übergabe und Datenfluss

Selbst zu hosten gibt dir volle Kontrolle und volle Verantwortung. Der Schnellstart der Anleitung deaktiviert die Authentifizierung und warnt, dass dies „keine Produktionsarchitektur" ist, sodass persistente Volumes, Auth, TLS und Monitoring von dir hinzugefügt werden müssen.

Firecrawl Local kommt mit engeren Standardwerten für einen einzelnen Rechner:

  • serve bindet an 127.0.0.1 und lehnt localhost und private Adressen ab, sofern du nicht --allow-private übergibst.
  • Link-Local- und Cloud-Metadaten-Adressen werden in jedem Modus blockiert, auch nach Weiterleitungen.
  • scrape, crawl und mcp akzeptieren --public-only, was die README empfiehlt, wenn ein Agent Websites durchsucht, denen du nicht vertraust.
  • Crawls respektieren robots.txt.

Der Kompromiss ist die Cloud-Übergabe. Mit dem Standardwert FIRECRAWL_CLOUD=auto gehen Suche, Seiten, die deinen Rechner blockieren, und Alexandria an Firecrawl Cloud. Diese Ergebnisse tragen "source": "firecrawl-cloud". Setze FIRECRAWL_CLOUD=search, um nur die Suche zu erlauben, oder off, um nichts zu senden.

Alexandria, Firecrawls Katalog von Datenanbietern, benötigt ein kostenloses Konto und firecrawl-local login. Unsere Firecrawl-Alexandria-Erklärung behandelt, was es liefert.

Welches solltest du wählen?

Wähle Firecrawl Local, wenn:

  • Du möchtest, dass ein KI-Agent auf deinem Laptop scrapt und crawlt. firecrawl-local init fügt den MCP-Server zu Claude Code, Claude Desktop, Cursor, Windsurf, Gemini CLI und Codex hinzu und sichert dabei zuvor jede Konfiguration.
  • Du führst kurze Jobs aus, die innerhalb einer Stunde abgeschlossen sind.
  • Du nur Markdown, HTML, rohes HTML und Links brauchst.
  • Du kein Postgres, Redis und RabbitMQ betreiben möchtest.

Behalte selbst gehostetes Firecrawl, wenn:

  • Crawl-Jobs einen Neustart überleben oder länger als eine Stunde laufen müssen.
  • Du json- oder summary-Ausgabe über dein eigenes Modell brauchst.
  • Die Suche auf deiner Infrastruktur bleiben muss.
  • Mehrere Dienste oder Nutzer ein gemeinsames Scraping-Backend hinter deiner Auth teilen.

Viele Teams werden beides betreiben: Local auf Laptops und in Agenten, den Docker-Stack oder Firecrawl Cloud in der Produktion. Für Agenten-Setups, die nur Suche benötigen, listet unsere Zusammenstellung Open-Source-Websuche für Claude weitere Optionen auf, und der Firecrawl-MCP- und llms.txt-Leitfaden behandelt den gehosteten MCP-Server.

SDK-Code von selbst gehostet zu Local migrieren

Dein SDK-Code ändert sich nicht, nur die URL: Setze die API-URL des Python- oder Node-SDK auf http://localhost:3002, ohne API-Schlüssel für lokale Routen. Bevor du umstellst, bestätige, dass dein Code keine v0- oder v1-Aufrufe macht, niemals json, summary oder actions anfordert und nie eine Crawl-ID abfragt, die älter als eine Stunde ist oder einen serve-Neustart überspannt.

Lass deinen Coding-Agenten mit der Apidog CLI einen Paritätstest durchführen

Das Wechseln von Backends ist eine Vertragsfrage: Liefert /v2/scrape auf Local dieselbe Form, die dein Code bereits parst? Vergleiche Antworten nicht von Hand. Betreibe beide Server nebeneinander (Docker auf 3002, firecrawl-local serve --port 3012) und lass deinen Coding-Agenten beide mit der Apidog CLI testen.

Richte es einmal ein:

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

Dann gib deinem Agenten einen Prompt:

Self-hosted Firecrawl runs on http://localhost:3002 and Firecrawl Local on http://localhost:3012. In Apidog project <id>, create two environments, "self-hosted" and "local". Add test cases for POST /v2/scrape on https://example.com (assert 200, success: true, non-empty data.markdown) and POST /v2/map (assert 200 and a non-empty links array). Run the cases against both environments and tell me every assertion that differs. 

Paritätstest: Ein Coding-Agent führt denselben Apidog-Testfall gegen den selbst gehosteten Stack auf Port 3002 und Firecrawl Local auf Port 3012 aus und vergleicht dann die beiden Berichte zu Status, success und Markdown

Der Agent liest das Payload-Schema, validiert es und führt denselben Fall zweimal aus:

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 

Die Apidog CLI sendet Anfragen von deinem Rechner, sodass beide localhost-Ports erreichbar sind. Ersetze -r cli,json durch -r junit, und derselbe Check läuft bei jedem Firecrawl-Upgrade in der CI; unser Apidog-CLI-CI/CD-Leitfaden zeigt das Setup, und Apidog CLI in Claude Code behandelt die Agenten-Seite. Der Free-Plan von Apidog deckt Teams mit bis zu 4 Nutzern ab.

FAQ

Ersetzt Firecrawl Local das selbst gehostete Firecrawl? Nein. Es ist ein separater Build in apps/local. Der vollständige Server in apps/api und seine Self-Hosting-Anleitung sind unverändert, und du brauchst ihn weiterhin für persistente Jobs und LLM-Formate.

Ist Firecrawl Local wirklich 37-mal schneller als selbst gehostetes Firecrawl? Das ist Firecrawls Behauptung aus seinem Launch-Post, zusammen mit 230-mal weniger Speicher und 11 MB im Leerlauf. Die README veröffentlicht keine Benchmark-Methode, also teste es an deinen eigenen URLs.

Funktioniert Firecrawl Local ohne die Cloud? Ja. Setze FIRECRAWL_CLOUD=off, und Scraping, Crawling und Mapping bleiben auf deinem Rechner. Suche, der Fallback für blockierte Seiten und Alexandria funktionieren nicht mehr.

Ist selbst gehostetes Firecrawl kostenlos? Der Code ist unter AGPL-3.0 kostenlos, sowohl für den Server als auch für Local. Du zahlst für die Maschinen und die Zeit, Postgres, Redis und RabbitMQ selbst zu betreiben.

Welches sollte ein KI-Agent verwenden? In den meisten Fällen Firecrawl Local. firecrawl-local init registriert es als MCP-Server in sechs Agenten-Tools, und --public-only hält einen Agenten davon ab, dein privates Netzwerk zu erreichen.