Firebase Emulators Docker

Production-ready Docker container for Firebase emulator suite.

Quick Start

docker run -d -p 5170-5179:5170-5179 charlesgreen/firebase-emulators:latest

Access the Emulator UI at http://localhost:5179

Features

• Zero configuration required
• Multi-platform support (linux/amd64, linux/arm64)
• Security hardened with non-root user
• Health checks included
• Optional seed data for testing
• All Firebase emulators pre-configured

Installation

Docker

docker pull charlesgreen/firebase-emulators:latest

Docker Compose

services:
  firebase:
    image: charlesgreen/firebase-emulators:latest
    ports:
      - "5170-5179:5170-5179"
    environment:
      - SEED_DATA=true

Port Configuration

Service	Port	URL
Hub	5170	http://localhost:5170
Auth	5171	http://localhost:5171
Firestore	5172	http://localhost:5172
Hosting	5174	http://localhost:5174
Storage	5175	http://localhost:5175
UI	5179	http://localhost:5179

Environment Variables

Variable	Default	Description
FIREBASE_PROJECT_ID	demo-project	Firebase project ID
SEED_DATA	false	Load sample data on startup

Development

Prerequisites

• Node.js 20+
• Docker
• npm

Setup

npm install
npm run build
npm run test

Build Docker Image

docker build -t firebase-emulators .

Run Tests

npm run test
npm run lint

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

MIT License - see the LICENSE file for details

Support

• Issues
• Docker Hub