Back to Documentation
Getting Started

Installation Guide

Choose the installation method that best fits your needs. We recommend starting with our Cloud SaaS option for the fastest setup.

Choose Your Installation Method

Cloud SaaS

RECOMMENDED

Zero installation. Sign up and start monitoring immediately.

Difficulty: EasiestSetup Time: 2 minutes

Docker

Run DB24x7 in containers with Docker Compose.

Difficulty: EasySetup Time: 5 minutes

Self-Hosted

Install directly on your server infrastructure.

Difficulty: ModerateSetup Time: 15 minutes

Cloud SaaS Installation

The fastest way to get started. No installation required, no infrastructure to manage.

Steps

  1. Visit db24x7.com/signup
  2. Create your account with email and password
  3. Verify your email address
  4. Log in to your dashboard
  5. Click "Add Database" to connect your first database

Benefits of Cloud SaaS

  • • Automatic updates and security patches
  • • 99.9% uptime SLA
  • • Scalable infrastructure
  • • No maintenance required
  • • Enterprise-grade security

Docker Installation

Deploy DB24x7 using Docker containers for easy deployment and management.

Prerequisites

  • Docker 20.10 or later
  • Docker Compose 2.0 or later
  • 4GB RAM minimum
  • 10GB disk space

Installation Steps

1. Create a docker-compose.yml file:

version: '3.8'

services:
  db24x7:
    image: db24x7/db24x7:latest
    container_name: db24x7
    ports:
      - "3000:3000"
    environment:
      - DB24X7_DB_URL=postgresql://user:pass@postgres:5432/db24x7
      - DB24X7_SECRET_KEY=${SECRET_KEY}
      - DB24X7_AI_API_KEY=${AI_API_KEY}
    depends_on:
      - postgres
    restart: unless-stopped
    volumes:
      - db24x7-data:/app/data

  postgres:
    image: postgres:15-alpine
    container_name: db24x7-postgres
    environment:
      - POSTGRES_USER=db24x7
      - POSTGRES_PASSWORD=secure_password
      - POSTGRES_DB=db24x7
    volumes:
      - postgres-data:/var/lib/postgresql/data
    restart: unless-stopped

volumes:
  db24x7-data:
  postgres-data:

2. Create a .env file:

SECRET_KEY=your_secret_key_here
AI_API_KEY=your_ai_api_key_here

3. Generate a secure secret key:

openssl rand -hex 32

4. Start the containers:

docker-compose up -d

5. Check the logs:

docker-compose logs -f db24x7

6. Access the web interface:

http://localhost:3000

Production Deployment

For production, use a reverse proxy (nginx/Traefik) with SSL, configure proper backup strategies for volumes, and use Docker secrets for sensitive data instead of environment variables.

Self-Hosted Installation

Install DB24x7 directly on your server for maximum control and customization.

Prerequisites

  • Linux server (Ubuntu 20.04+, CentOS 7+, RHEL 7+)
  • Node.js 18 or later
  • PostgreSQL 12+ (for DB24x7 metadata)
  • 4GB RAM minimum
  • 20GB disk space

Installation Steps

1. Download the latest release:

curl -L https://releases.db24x7.com/latest/db24x7-linux-x64.tar.gz -o db24x7.tar.gz

2. Extract the archive:

tar -xzf db24x7.tar.gz && cd db24x7

3. Install dependencies:

npm install --production

4. Configure environment variables:

cp .env.example .env && nano .env

5. Run database migrations:

npm run migrate

6. Start the application:

npm start

Running as a Service (systemd)

# /etc/systemd/system/db24x7.service
[Unit]
Description=DB24x7 Database Monitoring
After=network.target postgresql.service

[Service]
Type=simple
User=db24x7
WorkingDirectory=/opt/db24x7
Environment=NODE_ENV=production
ExecStart=/usr/bin/node /opt/db24x7/dist/server.js
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target
sudo systemctl enable db24x7sudo systemctl start db24x7

Environment Variables

Configure DB24x7 using these environment variables.

VariableRequiredDefaultDescription
DB24X7_PORTNo3000Port for the web interface
DB24X7_DB_URLYesN/APostgreSQL connection string for DB24x7's metadata storage
DB24X7_SECRET_KEYYesN/ASecret key for encryption (generate with openssl rand -hex 32)
DB24X7_AI_API_KEYNoN/AAPI key for AI features (OpenAI, Anthropic, etc.)
DB24X7_SMTP_HOSTNoN/ASMTP server for email notifications
DB24X7_LOG_LEVELNoinfoLogging level: debug, info, warn, error

Verify Installation

Post-Installation Checklist

  • Access the web interface at the configured URL
  • Create an admin account
  • Check that all services are running
  • Review logs for any errors
  • Test database connectivity

Health Check Command

Verify that DB24x7 is running correctly:

curl http://localhost:3000/health

Expected response: {"status": "healthy", "version": "1.0.0"}