Installation Guide for Jetbrains YouTrack Server

1. System Requirements

Before installation, ensure your environment meets these basics:

• 64-bit OS (Windows, macOS, Linux)
• Docker or ZIP environment supported
• Open port (default: 8080)
• Sufficient disk space for data, logs, and backups

2. Installation Methods

Option A - Docker (Recommended by JetBrains)

Step 1: Pull YouTrack Image

docker pull jetbrains/youtrack:<version>

Replace <version> with the latest version.

Step 2: Run the Container

docker run -it --name youtrack-server \
-v <data_dir>:/opt/youtrack/data \
-v <conf_dir>:/opt/youtrack/conf \
-v <logs_dir>:/opt/youtrack/logs \
-v <backups_dir>:/opt/youtrack/backups \
-p 8080:8080 \
jetbrains/youtrack:<version>

This command:

• Maps storage directories
• Exposes port 8080
• Starts YouTrack service

Step 3: Open Configuration Wizard

After startup, open in browser:

http://<your-server-ip>:8080/?wizard_token=<token>

The token appears in Docker logs.

Step 4: Initial Setup (Wizard)

Fill in:

• Base URL
• Port
• Data directories
• Admin username & password
• Enable/disable guest access

Then click Finish.

Option B - ZIP Distribution (Manual Install)

Step 1:

Download ZIP package from JetBrains website.

Step 2:

Extract files to your server directory.

Step 3:

Run startup script:

• Linux/macOS → bin/youtrack.sh start
• Windows → bin\youtrack.bat start

Step 4:

Open browser and complete same setup wizard.

(Flow is identical to Docker after launch)

3. Activation / Licensing Process

After installation, YouTrack prompts for a license.

1. Go to Administration → License
2. Paste your license key
3. Click Save