Rocket.Chat Docker Setup

A Docker Compose setup for running Rocket.Chat locally on Apple Silicon (ARM64) Macs.

Stack

Service	Image	Port
Rocket.Chat	p1626/rocketchat-arm64:7.9.3-r	3000
MongoDB	mongo:6	27017 (internal)

Note: The official Rocket.Chat image only supports amd64. This setup uses a community-maintained native arm64 build to avoid emulation warnings on Apple Silicon.

Prerequisites

• Docker Desktop installed and running

Getting Started

1. Clone the repository

git clone https://github.com/sumaiazaman/rocketchat-setup.git
cd rocketchat-setup

2. Start the containers

docker-compose up -d

3. Initialize the MongoDB replica set (first time only)

Wait ~20 seconds for MongoDB to be healthy, then run:

docker exec mongo mongosh --eval "rs.initiate({ _id: 'rs0', members: [{ _id: 0, host: 'mongo:27017' }] })"

4. Open Rocket.Chat

Visit http://localhost:3000 in your browser and complete the setup wizard.

Useful Commands

# Stop containers
docker-compose down

# View logs
docker-compose logs -f

# View Rocket.Chat logs only
docker-compose logs -f rocketchat

# Restart
docker-compose restart

Data Persistence

MongoDB data is stored in a named Docker volume mongo-data. It persists across container restarts. To fully reset:

docker-compose down -v