p1626/rocketchat-arm64 repository overview

⁠Unofficial Rocket.Chat ARM64 Build

⁠Overview

This repository provides a working Docker image for running modern versions of Rocket.Chat on linux/arm64 (aarch64) platforms. The official Docker images for Rocket.Chat often lack timely support for this architecture, and building from source is a significant challenge due to dependency and build tool incompatibilities.

This image was purpose-built to provide a stable, out-of-the-box solution, resolving common and frustrating runtime errors including:

• Fatal errors with the sharp image processing library.
• "Topology is closed" database connection race conditions.
• Strict Node.js version enforcement errors.

⁠Image Details

This build is based on the following verified component versions:

⁠How to Use This Image

To get started, create a docker-compose.yml file with the content below.

IMPORTANT: Replace https://your-domain.com with your own domain name.

version: '3.8'

services: rocketchat:

⁠Use the specific, version-locked tag for stability

image: p1626/rocketchat-arm64:7.9.3 platform: linux/arm64 restart: unless-stopped volumes:

• ./uploads:/app/uploads environment:

⁠--- IMPORTANT: CHANGE THIS VALUE ---

• ROOT_URL=https://your-domain.com⁠

⁠--- These values should be kept as is for this setup ---

• MONGO_URL=mongodb://mongo:27017/rocketchat?replicaSet=rs0
• MONGO_OPLOG_URL=mongodb://mongo:27017/local
• PORT=4000 ports:

⁠This maps the container's port 4000 to the host's port 4000

⁠Ensure your reverse proxy (e.g., Nginx) points to this host port

• "127.0.0.1:4000:4000" depends_on: mongo: condition: service_healthy

mongo: image: mongo:5.0 platform: linux/arm64 restart: unless-stopped volumes:

• ./data/db:/data/db command: mongod --oplogSize 128 --replSet rs0 --storageEngine wiredTiger healthcheck: test: "mongosh --eval 'db.adminCommand("ping")'" interval: 10s timeout: 5s retries: 5 start_period: 20s

text

⁠First-Time Setup Instructions

1. Save the file: Save the content above into a file named docker-compose.yml.

2. Start the services: From your terminal, in the same directory as your file, run:

   docker compose up -d
   

   Copy

3. Initialize the database: This is a critical one-time step. After the containers have started (wait ~15-30 seconds), run the following command to initialize the MongoDB replica set:

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

   Copy

4. Access your server: Your Rocket.Chat instance should now be running and fully accessible at the ROOT_URL you configured.

⁠Disclaimer

This is an unofficial, community-provided build. It is not affiliated with or supported by Rocket.Chat Inc. It was created to help users on ARM64 platforms get a working instance of Rocket.Chat running.