Back to all templates
InfluxDB logo

InfluxDB

Database512MB+ RAM

Time-series database for metrics, events, and real-time analytics

databasetimeseriesmetricsiot

Deploy InfluxDB in 3 Steps

1

Connect Your VPS

Add your server credentials to Server Compass

2

Select InfluxDB

Choose from our template library

3

Deploy & Configure

Fill in settings and click Deploy

No Docker knowledge required
Step-by-step deployment guide

Deploy InfluxDB on a VPS with Server Compass

Use the InfluxDB template in Server Compass to deploy a time-series database for metrics and events on your VPS, then verify the internal health endpoint.

About 10 minutesBrowser verified
1
Step 1

Open the server Apps tab

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

Server Compass Apps tab before creating an InfluxDB app
2
Step 2

Choose an app template

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

Choosing to deploy an app from a Server Compass template
3
Step 3

Search for InfluxDB

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

Searching for InfluxDB in the Server Compass template picker
4
Step 4

Select the InfluxDB template

Choose the InfluxDB template. Server Compass fills the InfluxDB container, persistent data and config volumes, host port, admin username, generated password, organization, bucket, and admin token.

InfluxDB template selected in Server Compass
5
Step 5

Review the InfluxDB settings

Confirm the app name and compose service. In this run, the app was named influxdb-demo and used host port 8086.

Reviewing InfluxDB project settings and compose services
6
Step 6

Deploy InfluxDB

Review the generated environment values, keep the admin password and token masked, confirm the HTTP port is available, and click Deploy Now.

Reviewing InfluxDB environment variables and port before deployment
7
Step 7

Watch the deployment progress

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

Server Compass deploying the InfluxDB template on the VPS
8
Step 8

Confirm InfluxDB is running

After deployment finishes, return to the Apps tab and confirm the InfluxDB app is marked Running with the database port available.

InfluxDB template running in the Server Compass Apps tab
9
Step 9

Verify InfluxDB is reachable

Open the app detail view and verify the running InfluxDB container. In this tutorial run, the internal /health endpoint reported that InfluxDB was ready.

InfluxDB app detail screen after verifying the deployed database container

After InfluxDB Opens

  • Store the generated InfluxDB password and admin token in a secure password manager.
  • Create application-specific buckets and API tokens before production use.
  • Restrict external access to port 8086 unless remote clients explicitly need it.
  • Configure regular backups for the InfluxDB data and config volumes before storing production data.
  • Use HTTPS before exposing the InfluxDB UI or API publicly.

Verified Result

The InfluxDB container returned ready health status from an internal curl request.

InfluxDB deployment questions

What does the InfluxDB template deploy?

It deploys an InfluxDB 2 container with persistent data and config volumes, initial organization, bucket, admin user, generated password, and admin token.

Which port did the tutorial use?

The tutorial used host port 8086, which maps to InfluxDB container port 8086.

Why is there no browser verification screenshot?

InfluxDB includes a web UI, but the tutorial verifies it with the internal /health endpoint so credentials and tokens are not shown in browser screenshots.

Should this become a blog post?

No. The deployment guide should live on the InfluxDB template detail page and be linked from the reusable template deployment docs page.

Terminal Deployment

InfluxDB CLI Deployment

Deploy InfluxDB the traditional way with SSH and Docker Compose.

1

Access Your VPS via Terminal

Open a terminal session and log into your VPS. Replace the placeholder with your actual IP.

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

2

Set Up Project Folder

Create a workspace for your deployment files.

terminal
# Create and navigate to project directory
mkdir -p ~/apps/influxdb
cd ~/apps/influxdb
3

Create the Compose File

Configure your containers with this Docker Compose setup:

docker-compose.yml
services:
  influxdb:
    image: influxdb:2-alpine
    ports:
      - "8086:8086"
    environment:
      - DOCKER_INFLUXDB_INIT_MODE=setup
      - DOCKER_INFLUXDB_INIT_USERNAME=admin
      - DOCKER_INFLUXDB_INIT_PASSWORD=<your-influx-password>
      - DOCKER_INFLUXDB_INIT_ORG=myorg
      - DOCKER_INFLUXDB_INIT_BUCKET=mybucket
      - DOCKER_INFLUXDB_INIT_ADMIN_TOKEN=<your-influx-token>
    volumes:
      - influxdb_data:/var/lib/influxdb2
      - influxdb_config:/etc/influxdb2
    restart: unless-stopped

volumes:
  influxdb_data:
  influxdb_config:
Deployment Settings
PORTHost port(default: 8086)
INFLUX_USERUsername(default: admin)
INFLUX_PASSWORDPassword
INFLUX_ORGOrganization(default: myorg)
INFLUX_BUCKETBucket(default: mybucket)
INFLUX_TOKENAPI token
4

Deploy Your Stack

Spin up the containers and verify the deployment.

terminal
# Start all services
docker compose up -d

# List running containers
docker compose ps

# Watch the logs
docker compose logs -f
5

Update Firewall Settings

Allow incoming traffic on the application port.

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

# Access your app at:
# http://your-server-ip:8086
Skip the Terminal

Skip the terminal. Use Server Compass instead.

Server Compass makes deploying InfluxDB effortless. Visual setup, one-click deploy, done.

  • 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 InfluxDB with Server Compass, complete these steps to finish setup

1

Access UI

2

Create buckets for different data

3

Set up Telegraf for data collection

Need help? Check out our documentation for detailed guides.

InfluxDB FAQ

Common questions about self-hosting InfluxDB

How do I deploy InfluxDB with Server Compass?

Simply download Server Compass, connect to your VPS, and select InfluxDB 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 InfluxDB?

InfluxDB requires a minimum of 512MB RAM. We recommend a VPS with at least 1024MB RAM for optimal performance. Any modern Linux server with Docker support will work.

Can I migrate my existing InfluxDB data?

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

How do I update InfluxDB to the latest version?

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

Is InfluxDB free to self-host?

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

Ready to Self-Host InfluxDB?

Download Server Compass and deploy InfluxDB to your VPS in under 3 minutes. No Docker expertise required.

Download Server Compass