Skip to content

Installing PrivMX Team Server using docker

brtfx edited this page Aug 13, 2025 · 2 revisions

Configuration

Clone the team server composer repository

git clone https://github.com/privmx/privmx-team-server-docker.git

and edit the .env file to adjust it to your needs. You should definitely set the PRIVMX_DOMAIN value:

  • PRIVMX_DOMAIN - domain name for your Team Server
  • PRIVMX_PORT - port
  • PRIVMX_NAME - instance name ("Matt's Team")
  • PRIVMX_SECURE - if you use the server via https, set it to true (it's just for setting link generation scheme)
  • PRIVMX_MONGO_DB - mongodb database name
  • PRIVMX_MONGO_URL - url for external mongodb instance (if you want to use an external mongodb instance, you can remove entire mongodb service from docker-compose.yml).

First run

Start docker:

docker-compose up -d

After docker starts for the first time, an activation token (ACToken) is generated by the Team Server - you can find it in file

./volumes/app/data/{your-domain}-{date}.actoken

Run PrivMX client app on your computer to activate the server:

  1. Download and install the PrivMX desktop application,
  2. on the login screen, select "Use ACToken" and paste the token generated by your server.
  3. Set an username and password for the first user (Team Keeper account) and complete the activation

Additional configuration

After the first run, a Team Server configuration file is generated:

./volumes/app/conf/{your-domain}/conf.json

You can change it as you wish, but after that, remember to restart the server:

docker-compose restart

Location of data

All Team Server data is stored by mongodb here:

./volumes/mongodb

(we use official mongodb docker image).

Clone this wiki locally