Quickstart¶

The fastest way to run Terranova is with Docker. No cloning, no building — pull the pre-built image and go.

Prerequisites¶

• Docker Engine 20.10+
• Docker Compose v2

1. Create a compose file¶

Create a file named compose.yaml with the following content:

services:
    terranova:
        image: ghcr.io/esnet/terranova:latest
        ports:
            - 9999:80
        volumes:
            - terranova-data:/data
        environment:
            TERRANOVA_CORS_ORIGINS: "http://localhost:9999"

volumes:
    terranova-data:

2. Start the app¶

docker compose up

3. Open the app¶

Open your browser to:

http://localhost:9999

Log in with the default credentials:

• Username: admin
• Password: admin

4. Connect your data¶

Terranova displays topology data from Google Sheets. To connect a spreadsheet:

1. Go to Settings in the top navigation
2. Click Add Google Sheets Datasource
3. Paste your Google service account JSON key

Next steps¶

• Create your first dataset
• Create your first map
• Docker deployment reference