Lago

Application1024MB+ RAM

Open-source metering and billing for usage-based pricing

Download Server Compass View Documentation

billingmeteringusage-basedsaas

Deploy Lago in 3 Steps

Connect Your VPS

Add your server credentials to Server Compass

Select Lago

Choose from our template library

Deploy & Configure

Fill in settings and click Deploy

No Docker knowledge required

Manual Setup Guide

Set Up Lago from Terminal

Get your hands dirty: manual Lago deployment guide for developers.

Access Your VPS Terminal

Use your terminal to securely access your server. You'll need your server's IP address.

terminal

# Connect via SSH
ssh root@your-vps-ip

# Alternative with key file
ssh -i /path/to/key root@your-vps-ip

First time? Make sure Docker is installed on your VPS. Run: curl -fsSL https://get.docker.com | sh

Set Up the Deployment Folder

Initialize a project folder on your server.

terminal

# Create and navigate to project directory
mkdir -p ~/apps/lago
cd ~/apps/lago

Set Up the Stack Definition

Use this Docker Compose configuration for your deployment:

docker-compose.yml

services:
  api:
    image: getlago/api:latest
    ports:
      - "3000:3000"
    environment:
      - DATABASE_URL=postgresql://lago:<your-db-password>@db:5432/lago
      - REDIS_URL=redis://redis:6379
      - SECRET_KEY_BASE=<your-secret-key>
    restart: unless-stopped
    depends_on:
      - db
      - redis

  front:
    image: getlago/front:latest
    ports:
      - "80:80"
    environment:
      - API_URL=http://api:3000
    restart: unless-stopped

  db:
    image: postgres:16-alpine
    environment:
      - POSTGRES_USER=lago
      - POSTGRES_PASSWORD=<your-db-password>
      - POSTGRES_DB=lago
    volumes:
      - postgres_data:/var/lib/postgresql/data
    restart: unless-stopped

  redis:
    image: redis:7-alpine
    restart: unless-stopped

volumes:
  postgres_data:

Environment Variables

PORTFrontend port(default: 80)

API_PORTAPI port(default: 3000)

SECRET_KEYSecret key

DB_PASSWORDDB password

Start the Containers

Bring up your containers in detached mode.

terminal

# Start all services
docker compose up -d

# List running containers
docker compose ps

# Watch the logs
docker compose logs -f

Set Up Firewall Rules

Allow the application port through your server's firewall.

terminal

# Allow the application port through firewall
sudo ufw allow 80/tcp
sudo ufw reload

# Access your app at:
# http://your-server-ip:80

Skip the Terminal

Let Server Compass do the heavy lifting.

Why type commands when you can click? Deploy Lago the easy way with Server Compass.

Beautiful interface
One-click deploys
Let's Encrypt SSL
Zero downtime
Container monitoring
Easy rollbacks

Download Server Compass$29 one-time • Lifetime license

After Deployment

After deploying Lago with Server Compass, complete these steps to finish setup

Create organization

Define billable metrics

Create plans and customers

Need help? Check out our documentation for detailed guides.

Lago FAQ

Common questions about self-hosting Lago

How do I deploy Lago with Server Compass?

Simply download Server Compass, connect to your VPS, and select Lago from the templates list. Fill in the required configuration and click Deploy. The entire process takes under 3 minutes.

What are the system requirements for Lago?

Lago 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.

Can I migrate my existing Lago data?

Yes! Server Compass provides volume mapping that allows you to import existing data. You can also use standard Lago backup and restore procedures.

How do I update Lago to the latest version?

Server Compass makes updates easy. Simply click the Update button in your deployment dashboard, and the latest Lago image will be pulled and deployed with zero downtime.

Is Lago free to self-host?

Lago 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.