Quick Start

Get VANTAGE running from scratch in under 5 minutes.

No default credentials

The system ships with no pre-created users. Step 3 below is mandatory — skip it and the platform will refuse all authenticated requests.

Prerequisites: Docker Engine 24+ and Docker Compose 2.20+ installed and running.

Step 1 — Clone the repository

git clone https://github.com/nilsonpmjr/Vantage.git
cd Vantage

Step 2 — Configure the environment

cp .env.example .env

Open .env and fill in the required values. At minimum:

# MongoDB credentials (choose your own)
MONGO_USER=vantage
MONGO_PASSWORD=<strong-password>

# JWT secret (generate with: openssl rand -hex 32)
SECRET_KEY=<your-secret>

# At least one threat-intelligence API key
VIRUSTOTAL_API_KEY=<your-key>

See Environment Variables for the full variable reference.

Step 3 — Start the stack

docker compose up -d

Wait for all containers to become healthy:

docker compose ps

The vantage_backend container must show healthy before proceeding.

Step 4 — Create the first admin account

docker compose exec backend python bin/console setup:create-admin

You will be prompted interactively:

=== VANTAGE — Initial Setup ===

Creating the first administrator account.
This command can only be run once.

Full name: _
Username: _
E-mail: _
Password: _ (hidden)
Confirm password: _ (hidden)
Preferred language [pt/en/es, default: pt]: _

✓ Administrator created successfully!
✓ Access the system at: http://localhost

Step 5 — Open the platform

Navigate to http://localhost (or the host you configured in CORS_ORIGINS).

Log in with the credentials you created in step 4.


What’s next?