FleetManager Server

Docker installation of FleetManager on your own server.

Prerequisites

  • Linux server with Docker and Docker Compose
  • Reverse proxy with HTTPS termination (e.g. Traefik, nginx)
  • At least 1 GB RAM and 10 GB disk space

1. Set up Docker Compose

Create a docker-compose.yml:

version: "3.8"

services:
  fleetmanager:
    image: brinkhausgmbh/fleetmanager:latest
    restart: unless-stopped
    ports:
      - "8000:8000"
    environment:
      - DATABASE_URL=postgresql://fleet:${DB_PASSWORD}@db:5432/fleetmanager
      - SECRET_KEY=${SECRET_KEY}
      - ALLOWED_ORIGINS=https://fleet.example.com
    depends_on:
      - db

  db:
    image: postgres:16-alpine
    restart: unless-stopped
    volumes:
      - pgdata:/var/lib/postgresql/data
    environment:
      - POSTGRES_DB=fleetmanager
      - POSTGRES_USER=fleet
      - POSTGRES_PASSWORD=${DB_PASSWORD}

volumes:
  pgdata:

2. Environment Variables

Create a .env file in the same directory:

# Database password
DB_PASSWORD=a-secure-password

# Secret key for JWT tokens
SECRET_KEY=a-long-random-string

# Optional: SMTP for password reset
SMTP_HOST=smtp.example.com
SMTP_PORT=587
SMTP_USER=fleet@example.com
SMTP_PASSWORD=smtp-password

Important: Protect the .env file with chmod 600 .env.

3. Start and Verify

# Start the stack
docker compose up -d

# Check logs
docker compose logs -f fleetmanager

# Health check
curl -sk https://fleet.example.com/health

Updating to a New Version

docker compose pull
docker compose up -d

Database migrations are run automatically on startup.

Docker Image

The official image is published on Docker Hub:

docker pull brinkhausgmbh/fleetmanager:latest

# Or a specific version:
docker pull brinkhausgmbh/fleetmanager:4.13.0

Available tags: :latest, :X.Y.Z, :X.Y, :X

Changelog

4.13.0 2026-03-11

Added

  • Agent command system: modules can advertise available commands (e.g. "Renew baseline") in the dashboard
  • New "Commands" tab in instance detail dialog for triggering and tracking agent commands
  • Command queue: commands are automatically delivered on next agent contact
  • Confirmation dialog before command execution with i18n labels and icons

Fixed

  • Whitelist rules with square brackets in message patterns were not applied during ingest
4.12.2 2026-03-11

Added

  • Firewall rule changes shown as color-coded diff view in status log

Fixed

  • Status snapshots from security agents were discarded on receipt
4.11.0 2026-03-11

Added

  • Customer management: license column shows device usage and limit exceeded status
  • SSO to license portal: "Upgrade license" without re-authentication
4.10.0 2026-03-11

Added

  • OS detection: OS type and version visible in dashboard
  • Device usage display in license dialog with progress bar
  • Dashboard warning banner when device limit is exceeded
  • Soft-limit enforcement: after 14-day grace period, new devices are rejected when limit is exceeded
4.9.0 2026-03-10

Added

  • Delete own account: users can self-delete their account
  • Onboarding guide in dashboard: guided first-time setup with step-by-step instructions
  • Customer-specific rejection logs visible under Logs

Security

  • Password complexity rules: minimum 10 characters, upper/lowercase, digit or special character
4.8.0 2026-03-10

Added

  • Self-service registration: new customers can create an account directly from the login page
  • Per-customer licensing with license key validation against the license server
  • License management in dashboard: view, enter and change license key
  • Support contact information based on license tier
4.7.1 2026-03-08

Fixed

  • Dashboard: Help text icon only shown when help text is available
  • Dashboard: Negative cache prevents repeated API requests for missing help texts
4.7.0 2026-03-08

Added

  • Diagnostic help texts: New ingest endpoint and dashboard integration (tooltip + overlay)
  • Ingest API responds with HTTP 202 when help texts are missing
4.6.3 2026-03-06

Added

  • CHANGELOG.md and RELEASING.md for unified release process
  • CI: GitLab Release job with automatic changelog extraction
4.6.0 2026-03-05

Added

  • Versioned DB migrations

Fixed

  • View definition corrected
4.5.1 2026-03-05

Added

  • Traffic light: sticky alerts ignored when last batch is green
  • Version tooltip in frontend
4.4.0 2026-03-04

Added

  • Diagnostics whitelist: pattern-based event suppression
0.9.0 2026-03-04

Added

  • Security monitoring: alert stickiness, notifications, retention, log search
  • Password reset and 2FA (TOTP)
  • OpenAPI documentation with tags and response models
  • Status snapshots: full StatusEngine tree

Start for free — 5 devices included

Fleet monitoring and security compliance in under 10 minutes. No credit card required.

Want to talk to an expert?

Click the link and we'll have a quick chat.

Schedule a Call →