Skip to content

Quick Start

Get Dependency-Track running locally in minutes.

Prerequisites

Setup

Download the Compose file and start the stack:

1
2
curl -O https://raw.githubusercontent.com/DependencyTrack/hyades/main/docs/getting-started/docker-compose.quickstart.yml
docker compose -f docker-compose.quickstart.yml up

1
2
Invoke-WebRequest -Uri "https://raw.githubusercontent.com/DependencyTrack/hyades/main/docs/getting-started/docker-compose.quickstart.yml" -OutFile "docker-compose.quickstart.yml"
docker compose -f docker-compose.quickstart.yml up

This will pull the required images, initialize the database, and start all services.

Compose file contents 
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
name: Dependency-Track

services:
  apiserver:
    image: ghcr.io/dependencytrack/hyades-apiserver:snapshot
    depends_on:
      postgres:
        condition: service_healthy
    deploy:
      resources:
        limits:
          memory: 2g
    environment:
      DT_DATASOURCE_URL: "jdbc:postgresql://postgres:5432/dtrack"
      DT_DATASOURCE_USERNAME: "dtrack"
      DT_DATASOURCE_PASSWORD: "dtrack"
    ports:
    - "127.0.0.1:8080:8080"
    volumes:
    - "apiserver-data:/data"
    restart: unless-stopped

  frontend:
    image: ghcr.io/dependencytrack/hyades-frontend:snapshot
    environment:
      API_BASE_URL: "http://localhost:8080"
    ports:
    - "127.0.0.1:8081:8080"
    restart: unless-stopped

  postgres:
    image: postgres:18-alpine
    environment:
      POSTGRES_DB: "dtrack"
      POSTGRES_USER: "dtrack"
      POSTGRES_PASSWORD: "dtrack"
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U $${POSTGRES_USER} -d $${POSTGRES_DB}"]
      interval: 5s
      timeout: 3s
      retries: 3
    volumes:
    - "postgres-data:/var/lib/postgresql/data"

volumes:
  apiserver-data: {}
  postgres-data: {}

Access

Once the stack is up, open the frontend:

http://localhost:8081

Log in with the default credentials:

Username Password
admin admin

Note

You'll be prompted to change your password upon first login.

What's Next