Run Docker Container as a Service
Docker recommends using their cross-platform built-in restart policy for running a container as a service. For this, configure your Docker service to start on system boot and add the --restart unless-stopped parameter to the docker run command that starts YouTrack.
If you want to start multiple services one after the other, including YouTrack, the restart policy won't work well. In such cases, it's better to use a process manager instead.
Specific instructions for setting up a restart policy vary by operating system. To make sure you see information that is relevant to your installation, select the tab that corresponds with the operating system used in your host environment.
Here's an example of how to run YouTrack container as a service on Linux with help of systemd.
To run the YouTrack container as a service on Linux with systemd
Create a service descriptor file
/etc/systemd/system/docker.youtrack.service:[Unit] Description=YouTrack Service After=docker.service Requires=docker.service [Service] TimeoutStartSec=0 Restart=always ExecStartPre=-/usr/bin/docker exec %n stop ExecStartPre=-/usr/bin/docker rm %n ExecStartPre=/usr/bin/docker pull jetbrains/youtrack:<version> ExecStart=/usr/bin/docker run --rm --name %n \ -v <path to data directory>:/opt/youtrack/data \ -v <path to conf directory>:/opt/youtrack/conf \ -v <path to logs directory>:/opt/youtrack/logs \ -v <path to backups directory>:/opt/youtrack/backups \ -p <port on host>:8080 \ --stop-timeout 60 \ jetbrains/youtrack:<version> ExecStop=/usr/bin/docker exec %n stop [Install] WantedBy=default.targetEnable starting the service on system boot with the following command:
systemctl enable docker.youtrack
You can also stop and start the service manually at any moment with the following commands, respectively:
For Windows Server, you can run YouTrack with Docker Compose and rely on the container restart policy to start it automatically after the host restarts.
Prepare the host to run Windows containers using a supported container runtime. For setup guidance, refer to the installation instructions and the official Windows documentation.
Create a Docker Compose File.
A Docker Compose file is typically a
.ymlthat defines your containerized application and its configuration. In this case, your file contains the parameters you would typically use to run YouTrack.Here's an example you can use as a guide for writing your file:
version: "3" services: YouTrack: container_name: youtrack-server image: jetbrains/youtrack-windows:<version> user: "13001:13001" restart: unless-stopped ports: - "<port on host>:8080" volumes: - <path to data folder>:C:/opt/youtrack/data - <path to conf folder>:C:/opt/youtrack/conf - <path to logs folder>:C:/opt/youtrack/logs - <path to backups folder>:C:/opt/youtrack/backupsStart the Compose application.
Open a Command Prompt or PowerShell with administrative privileges. Navigate to the directory where your Docker Compose file is located and use the following command:
docker compose -f docker-compose.yml up -dThis command starts YouTrack in detached mode and applies the restart policy declared in the Compose file.
You can then manage the YouTrack container using standard Docker Compose commands. For example:
To stop the service, use:
docker compose -f docker-compose.yml downTo check the service status, use:
docker compose -f docker-compose.yml ps
If the server shuts down for whatever reason, Docker will automatically restart the container on reboot.
In order for this to work, you must configure the container runtime and the Windows Server host to start automatically when the server boots up. For specific instructions, please refer to the documentation for your server operating system and container runtime.