Installation

Get Lastboard up and running using your preferred method. We officially support Docker and native Linux installations.

Requirements

• Docker Method: Docker and Docker Compose installed.
• Native Method: Linux OS (amd64 or arm64).

Method 1: Docker (Recommended)

The easiest way to install Lastboard is via Docker Compose. Images are published to our self-hosted registry at git.codigosh.com.

Note: If your Docker daemon returns an authentication error when pulling the image, log in first:

docker login git.codigosh.com

Create a docker-compose.yml file with the following content:

services:
  lastboard:
    image: git.codigosh.com/codigosh/lastboard:latest
    container_name: lastboard
    ports:
      - "8080:8080"
    environment:
      - TZ=America/New_York
      # - TRUST_PROXY=true   # Uncomment if running behind a reverse proxy
    volumes:
      - ./data:/var/lib/lastboard
    restart: unless-stopped
    logging:
      driver: "json-file"
      options:
        max-size: "10m"
        max-file: "3"

Start the container:

docker compose up -d

Method 2: Native Linux Installation

You can install Lastboard directly on your host machine using our automated script. This sets up a systemd service and runs the application.

Run the following command:

curl -fsSL https://git.codigosh.com/CodigoSH/Lastboard/raw/branch/main/install.sh | sudo bash

First Run

Once Lastboard is running, it will be available on port 8080 by default. Open your browser and navigate to http://your-server-ip:8080.

You will be greeted by the Setup Wizard, which walks you through creating your first admin user. Zero configuration files to touch!

Reverse Proxy Setup

If you plan to use a reverse proxy, you must set the TRUST_PROXY=true environment variable.

Nginx Example

server {
    listen 80;
    server_name dashboard.example.com;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;

        # WebSocket support
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

Caddy Example

dashboard.example.com {
    reverse_proxy 127.0.0.1:8080
}