Installation

Range Warden ships as a single Docker image containing both the Go API server and the React frontend.

Prerequisites

• Docker installed on your host machine.
• A directory on the host for persistent data (SQLite database).

Quick start with Docker

docker run -d \
  --name range-warden \
  -p 3000:3000 \
  -v range-warden-data:/data \
  ghcr.io/rangewarden/range-warden:latest

Note: The container image is not publicly available yet. This page will be updated with the correct image path when Range Warden launches.

Open http://localhost:3000 in your browser.

Docker Compose

Create a docker-compose.yml:

services:
  range-warden:
    image: ghcr.io/rangewarden/range-warden:latest
    ports:
      - "3000:3000"
    volumes:
      - range-warden-data:/data
    restart: unless-stopped

volumes:
  range-warden-data:

Then run:

docker compose up -d

Environment variables

Variable	Default	Description
PORT	3000	Port the server listens on
DATABASE_PATH	/data/range-warden.db	Path to the SQLite database file

Building from source

Source builds will be available once the repository is public. Check back after launch for instructions.

First login

On first run, Range Warden creates a default admin account:

• Email: admin@rangewarden.app
• Password: admin

Change this password immediately after your first login via Admin → Users.

Next steps

• First-Time Setup — Walk through initial configuration: branding, membership types, lanes, users, and more.
• Admin Settings — Detailed reference for all configuration options.
• Membership Management — Start adding members.