Compose to create working TeamCity server with PostgreSQL and Agents

This configuration use only official images:

teamcity server, teamcity agent, postgres

Clone this repository or download the zip.

git clone https://github.com/Egregors/teamcity-docker-compose.git

First of all, you should set your Postgres username and password variables in env.example and rename env.example to .env

Don't push .env file in public repositories!

It's all. PostgreSQL already configured according to the JetBrains recommendations

To add HTTPs nginx-proxy with Let's Encrypt certificates (see https://github.com/JrCs/docker-letsencrypt-nginx-proxy-companion) just set your domain name and email for nginx service in compose file:

  nginx:
    image: nginx
    links:
      - teamcity-server
    volumes:
      - "./server/etc/nginx/conf.d/:/etc/nginx/conf.d/"
    environment:
      # set your domain name and email!
      VIRTUAL_HOST: ci.example.com
      LETSENCRYPT_HOST: ci.example.com
      LETSENCRYPT_EMAIL: [email protected]

If you don't need HTTPs support – remove nginx, nginx-proxy and letsencrypt-nginx-proxy-companion services from your docker-compose file

Next, build the images:

cd teamcity-docker-compose
docker-compose build

Now you can Up the service and continue settings in Web Interface:

docker-compose up

After initialisation Web Interface will be available on https://yourdockerhost/ (with HTTPs support) or http://yourdockerhost:8111/

Open https://yourdockerhost/ or http://yourdockerhost:8111/

Set PostgreSQL as database type and click «Refresh JDBC drivers»

Configurate DB connection:

Authorize your Agent:

Done, TeamCity basically ready to work.

Scaling you workers (agents) supported as well. Just use docker-compose scale command:

docker-compose scale teamcity-agent=3

Keep in mind, currently, agents are stateless

You may use JetBrains way to backup or restore your server

You can use our preconfigured custom agents with already installed necessary dependencies

Agent info

Run server + agent:

docker-compose -f tc-django-nodejs-agent.yml build
docker-compose -f tc-django-nodejs-agent.yml up
# optional
docker-compose -f tc-django-nodejs-agent.yml scale teamcity-django-agent=3

Bug reports, bug fixes, and new features are always welcome. Please open issues, and submit pull requests for any new code.