Installation

Installation

LogNorth runs as a single Docker container with SQLite storage.

Managed Install (Recommended)

One command. Automatic updates. SSL included.

curl -fsSL lognorth.com/install | sudo bash

The installer:

• Prompts for your domain
• Sets up Caddy with automatic SSL
• Starts LogNorth with Docker
• Enables automatic updates

Using an AI coding assistant? The AI-assisted installation skill can provision a server, harden it, and install LogNorth for you.

---

Manual Install

Run LogNorth yourself with Docker.

Docker

docker run -d \
  --name lognorth \
  -p 8080:8080 \
  -v lognorth_data:/data \
  ghcr.io/lognorth/lognorth:latest

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

Docker Compose

version: '3.8'
services:
  lognorth:
    image: ghcr.io/lognorth/lognorth:latest
    ports:
      - "8080:8080"
    volumes:
      - lognorth_data:/data
    restart: unless-stopped

volumes:
  lognorth_data:

Environment Variables

Variable	Description	Default
LOGNORTH_PORT	HTTP port	8080
LOGNORTH_STORAGE_PATH	Data directory	/data

Reverse Proxy

Put LogNorth behind nginx or Caddy for HTTPS:

server {
    server_name logs.yoursite.com;

    location / {
        proxy_pass http://localhost:8080;
        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;
    }
}

---

Security

LogNorth does not harden your server. Server security is your responsibility.

Before exposing LogNorth to the internet:

• Use a non-root user with sudo privileges
• Enable SSH key authentication (disable password login)
• Configure a firewall (only open ports 80/443)
• Enable automatic OS security updates

See DigitalOcean’s Ubuntu Server Setup Guide for a solid baseline.

Next Steps

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