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 | 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? Install the LogNorth plugin after setup and your agent can read the logs while it debugs.

---

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;
    }
}

---

Cloudflare (Recommended)

We strongly recommend putting your LogNorth instance behind Cloudflare in proxied mode (orange cloud icon). This filters out bot scanners, vulnerability probes, and automated attacks before they reach your server. That keeps your error logs clean and your data meaningful.

Without Cloudflare, expect 90%+ of your logged requests to be bot noise (.env probes, .git/config scans, WordPress exploits, etc.).

Setup:

1. Add your domain to Cloudflare (free plan works)
2. Point the DNS A record to your server IP
3. Ensure the proxy toggle is enabled (orange cloud)
4. SSL mode: Full (strict)

---

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