Installation

Installation

LogNorth runs as a single Docker container with SQLite storage.

One-Line Install

curl -fsSL lognorth.com/install | sudo bash

This downloads LogNorth, starts it with Docker, and sets up automatic updates.

Manual Docker

docker run -d \
  --name lognorth \
  -p 3000:3000 \
  -v lognorth_data:/data \
  -e LICENSE_KEY=your-license-key \
  ghcr.io/lognorth/lognorth:latest

LogNorth is now running at http://localhost:3000

Docker Compose

version: '3.8'
services:
  lognorth:
    image: ghcr.io/lognorth/lognorth:latest
    ports:
      - "3000:3000"
    volumes:
      - lognorth_data:/data
    environment:
      - LICENSE_KEY=your-license-key
    restart: unless-stopped

volumes:
  lognorth_data:

What’s Included

• Web UI - Live view, search, issues dashboard
• API endpoint - POST /api/v1/events
• SQLite database - All data in one file
• Email alerts - Configure SMTP in settings

Environment Variables

Variable	Description	Default
LICENSE_KEY	Your LogNorth license key	Required
PORT	HTTP port	3000
DATA_DIR	Data directory	/data

Reverse Proxy

Put LogNorth behind nginx or Caddy for HTTPS:

server {
    server_name logs.yoursite.com;

    location / {
        proxy_pass http://localhost:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

Next Steps

1. Send your first event
2. Set up an integration