Firenook docs

Firenook is a drop-in replacement for the Firebase Local Emulator Suite. It runs your project from the files you already have: the same firebase.json, rules and Functions code, the same client and Admin SDKs, and the same ports. It serves Firestore, Authentication, Cloud Storage, Cloud Functions, Extensions, Pub/Sub, Cloud Tasks and Eventarc from one npm package, with no Java and nothing else to download.

Find your way

Get startedInstall Firenook, switch from the Firebase emulators, start a new project, connect your app, and run tests and CI.

ServicesWhat each emulator does: Firestore, Authentication, Cloud Storage, Cloud Functions, Extensions, Pub/Sub, Cloud Tasks, Eventarc and Security Rules.

Cloud Functions in depthScheduled functions, environment variables and secrets, debugging, and reload on save.

Your dataKeep data between runs, start from a seed, export snapshots, inspect and compact the store, and recover after a crash.

ToolsThe web console, the terminal screen, and the MCP server for your coding agent.

ReferenceEvery CLI command and flag, how configuration is read, the ports, and the MCP tools.

HelpTroubleshooting, the Java 21 error, Windows, running without a Google login, the FAQ, versions, and how to report a problem.

ContributeBuild Firenook from source, run its tests, and see how the launcher, engine and console fit together.

Status

These docs describe Firenook 0.2.0, the first release for public use. It runs on Node 22, 24 or 26, on macOS (Apple silicon and Intel), Linux x64 and arm64 with glibc 2.28 or newer, and Windows x64. Every release passes conformance replays against the official emulator and packed installs on all five platforms. Commit your lockfile and upgrade on purpose; see versions and verification.

Realtime Database, Hosting, App Hosting and Data Connect are not emulated. A firebase.json that configures them still starts, with a warning. Compatibility records what each service covers and what it does not.

Firenook is an independent open-source project under the Apache License 2.0, not affiliated with or endorsed by Google. Firebase and Cloud Firestore are trademarks of Google LLC.

Next

New here? Install Firenook. Already running the official emulator? Switch over.