Skip to content

Uptime Kuma

Uptime Kuma is an easy-to-use self-hosted monitoring tool.

Install Uptime Kuma

  1. Follow the Uptime Kuma installation guide.
  2. Install Uptime Kuma using either the Docker or Node.js method.
  3. Start the Uptime Kuma service.
  4. Access Uptime Kuma on port 3001.
  1. Follow the Uptime Kuma Installation guide to set up the Uptime Kuma service.
  2. Add the following ls-net external network to the Uptime Kuma project's compose.yaml file:

    services:
      uptime-kuma:
        image: louislam/uptime-kuma:2
        restart: unless-stopped
        volumes:
          - ./data:/app/data
        ports:
          - "3001:3001"
        networks:
          - ls-net
    networks:
      ls-net:
        external: true
    

Set up OpenLiteSpeed (OLS) proxy with AutoSSL

The easiest way to install OpenLiteSpeed, configure it as a reverse proxy, and enable AutoSSL is to use the ols1clk script.

Before continuing, ensure that your domain points to the server.

Replace www.example.com with your domain name, and run the following command:

bash <(curl -fsSL https://raw.githubusercontent.com/litespeedtech/ols1clk/master/ols1clk.sh) --proxy-c --proxy-port 3001 --proxy-s --autocert --sitedomain www.example.com

This command automatically:

  1. Download the ols-proxy-docker-env repository:

    git clone https://github.com/litespeedtech/ols-proxy-docker-env
    cd ols-proxy-docker-env
    
  2. Copy the example environment file:

    cp .env.example .env
    
  3. Edit .env with your configuration values:

    OLS_IMAGE=litespeedtech/openlitespeed:latest
    BACKEND_IP=uptime-kuma
    BACKEND_PORT=3001
    DOMAIN=www.example.com
    PROXY_METHOD=context
    PROXY_SOCKET=true
    ACME_EMAIL=admin@example.com
    
  4. Start the proxy:

    docker compose up -d
    

Verify the proxy configuration

Open https://www.example.com in a browser. The application interface should load through OpenLiteSpeed over HTTPS.

Warning

After verifying the configuration, restrict public access to port 3001 with your firewall.

Optional settings

You can further enhance your site's security by enabling features such as:

  • OWASP protection
  • reCAPTCHA
  • Per-client throttling
  • Realm protection
  • IP Allow/Deny

See the OpenLiteSpeed Security Guide for more information.