Docker & Docker Compose
Deploying Rocket.Chat with Docker and Docker Compose is as easy as it can get.
Installing Docker and Docker Compose
- Navigate to any directory of your choice create a
docker-compose.ymlbased on our example. OR you can download directly by executing the following command on your terminal.
1
curl -L https://go.rocket.chat/i/docker-compose.yml -O
Copied!
Editing Variables:
- Edit
image: registry.rocket.chat/rocketchat/rocket.chat:latestto specify, which image you wish to use (see section Docker Images Available ) - Edit
ROOT_URLfrom the defaulthttp://localhost:3000to match your domain name or IP address as you wish - If you have a registration token to automatically register the workspace you can provide with:1REG_TOKEN={your token here} docker-compose up -dCopied!
- Next, start up the container by executing:
1
docker-compose up -d
Copied!
This is going to:
- Start a MongoDB service named
mongo. - Start a service named
mongo-init-replicathat will wait formongoto be ready, connect to it, initialize it and terminate itself (mongowill keep running). - Start a service
rocketchat, that will also wait formongoto be ready, themongo-init-replicato initialize, and then run Rocket.Chat.
Mongo supports 24 x 7 operations and live backup. You should not need to restart it too frequently. See mongodb documentation for proper operation and management of a mongo server.
Optionally, if you want to manage your messages and configuration information, edit the file again to uncomment the volume mounts. Make sure you have a
data subdirectory to mount and store the data.Updating Rocket.Chat Docker Image
To update the
rocketchat docker image to the latest version, you can use the following commands. Your data should not be affected by this, since it's located in the mongo image.1
docker pull registry.rocket.chat/rocketchat/rocket.chat:latest
2
docker-compose stop rocketchat
3
docker-compose rm rocketchat
4
docker-compose up -d rocketchat
Copied!
Last modified 2d ago
Export as PDF
Copy link