Open the server Apps tab
Select your VPS, open the Apps tab, and start a new app deployment. Keep sensitive server details hidden before capturing or sharing screenshots.


Open-source business intelligence and analytics platform
Add your server credentials to Server Compass
Choose from our template library
Fill in settings and click Deploy
Use the Metabase template in Server Compass to deploy a self-hosted business intelligence and analytics platform with PostgreSQL metadata storage on your VPS, then verify the Metabase web UI in a browser.
Select your VPS, open the Apps tab, and start a new app deployment. Keep sensitive server details hidden before capturing or sharing screenshots.

Click New App and choose the template deployment path so Server Compass can load the built-in catalog.

Use the template picker search to find Metabase in the Server Compass template catalog.

Choose the Metabase template. Server Compass fills in the Metabase web service, PostgreSQL metadata database, generated database password, and mapped browser port.

Confirm the app name and compose services. In this run, the app was named metabase-demo and used host port 3000.

Review the generated environment values, confirm the port is available, and click Deploy Now.

Keep the deployment modal open while Server Compass uploads the compose file, pulls the Metabase image, starts the container, and verifies the stack.

After deployment finishes, return to the Apps tab and confirm the Metabase app is marked Running with its application URL available.

Open the application URL in a browser. The Metabase setup screen confirms the analytics app is reachable.

It deploys Metabase with a PostgreSQL metadata database for saved questions, dashboards, users, and settings.
The tutorial used host port 3000, which maps to the Metabase web service on container port 3000.
The tutorial verifies the clean Metabase setup UI because admin account creation, database connections, email, and permissions depend on the production instance.
No. The deployment guide should live on the Metabase template detail page and be linked from the reusable template deployment docs page.
Learn how to self-host Metabase with this hands-on deployment guide.
Open your terminal and connect to your server. Replace the IP address with your VPS IP.
# SSH into your server
ssh root@your-server-ip
# Using a custom SSH key
ssh -i ~/.ssh/id_rsa root@your-server-ipFirst time? Need Docker? Install it: curl -fsSL https://get.docker.com | sh
Set up a clean directory for your application.
# Create and navigate to project directory
mkdir -p ~/apps/metabase
cd ~/apps/metabaseSet up the container stack using this Docker Compose configuration:
services:
metabase:
image: metabase/metabase:latest
container_name: metabase
hostname: metabase
ports:
- "3000:3000"
environment:
MB_DB_TYPE: postgres
MB_DB_DBNAME: metabaseappdb
MB_DB_PORT: 5432
MB_DB_USER: metabase
MB_DB_PASS: <your-db-password>
MB_DB_HOST: postgres
volumes:
- /dev/urandom:/dev/random:ro
restart: unless-stopped
depends_on:
postgres:
condition: service_healthy
healthcheck:
test: curl --fail -I http://localhost:3000/api/health || exit 1
interval: 15s
timeout: 5s
retries: 5
postgres:
image: postgres:16
container_name: metabase-postgres
hostname: postgres
environment:
POSTGRES_USER: metabase
POSTGRES_DB: metabaseappdb
POSTGRES_PASSWORD: <your-db-password>
volumes:
- postgres_data:/var/lib/postgresql/data
restart: unless-stopped
healthcheck:
test: ["CMD-SHELL", "pg_isready -U metabase -d metabaseappdb"]
interval: 10s
timeout: 5s
retries: 5
start_period: 30s
volumes:
postgres_data:
PORTHost port to expose(default: 3000)DB_PASSWORDDatabase passwordLaunch your application stack in the background.
# Start the containers in detached mode
docker compose up -d
# Check if containers are running
docker compose ps
# View logs
docker compose logs -fConfigure your firewall to permit external connections.
# Allow the application port through firewall
sudo ufw allow 3000/tcp
sudo ufw reload
# Access your app at:
# http://your-server-ip:3000Let Server Compass handle the complexity. Deploy Metabase with a simple, intuitive interface.
After deploying Metabase with Server Compass, complete these steps to finish setup
Log in with admin credentials
Configure site settings
Need help? Check out our documentation for detailed guides.
Common questions about self-hosting Metabase
Simply download Server Compass, connect to your VPS, and select Metabase from the templates list. Fill in the required configuration and click Deploy. The entire process takes under 3 minutes.
Metabase requires a minimum of 1024MB RAM. We recommend a VPS with at least 2048MB RAM for optimal performance. Any modern Linux server with Docker support will work.
Yes! Server Compass provides volume mapping that allows you to import existing data. You can also use standard Metabase backup and restore procedures.
Server Compass makes updates easy. Simply click the Update button in your deployment dashboard, and the latest Metabase image will be pulled and deployed with zero downtime.
Metabase is open-source software. You only pay for your VPS hosting (typically $5-20/month) and optionally Server Compass ($29 one-time). No subscription fees or per-seat pricing.
Download Server Compass and deploy Metabase to your VPS in under 3 minutes. No Docker expertise required.
Download Server Compass