Self-Hosted Setup

Complete guide for self-hosted SlimRMM installation.

Overview

Self-hosted deployment gives you complete control over your data and infrastructure.

Prerequisites

• Linux server (Ubuntu 22.04 recommended)
• Docker and Docker Compose
• Domain name with DNS access
• SSL certificate (Let's Encrypt recommended)

Installation Steps

1. Server Preparation

# Update system
sudo apt update && sudo apt upgrade -y

# Install Docker
curl -fsSL https://get.docker.com | sudo sh
sudo usermod -aG docker $USER

# Install Docker Compose
sudo apt install -y docker-compose-plugin

2. Create Directory

sudo mkdir -p /opt/slimrmm
cd /opt/slimrmm

3. Download Configuration

# Download docker-compose.yml
curl -O https://raw.githubusercontent.com/slimrmm/slimrmm/main/docker-compose.yml

# Create environment file
cp .env.example .env

4. Configure Environment

Edit .env with your settings. See Configuration for details.

5. SSL Certificate

# Using Let's Encrypt
sudo apt install -y certbot
sudo certbot certonly --standalone -d rmm.yourdomain.com

# Copy certificates
sudo cp /etc/letsencrypt/live/rmm.yourdomain.com/*.pem /opt/slimrmm/ssl/

6. Start Services

docker compose up -d

7. Initialize Database

docker compose exec backend alembic upgrade head

8. Create Admin User

docker compose exec backend python -c "
from app.services.auth_service import create_admin_user
create_admin_user('admin', 'admin@example.com', 'YourSecurePassword')
"

Verification

1. Open https://rmm.yourdomain.com
2. Log in with admin credentials
3. Check health: https://rmm.yourdomain.com/health

Next Steps

• Install Agents
• Configure Integrations
• Set Up Monitoring