selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

logforge logo

Self-host logforge

V3.0.1

Docker dashboard with real-time logs, alerts, self-healing

ReleaseOpen SourceApache-2.0
Updated2 hours ago
Setup difficultyModerate
Stars
302
Ports
443 (HTTPS browser and API access to /unicron (container port, mapped from UNICRON_APP_PORT)), 8443 (mTLS endpoint for Unicron-agent enrollment and traffic (container port, mapped from UNICRON_AGENT_MTLS_PORT))
Docker
logforge/unicron
Install with Docker Compose

What is logforge?

LogForge Unicron runs as a single Docker Compose stack that provides a unified interface for viewing container logs, metrics, events, and file systems across local and remote hosts via enrolled agents. The alert engine supports custom rules with pre-built templates for restart loops, resource pressure, error patterns, and suspicious activity. Alerts can be delivered through multiple notification channels. Remediation actions like restarting, stopping, starting, or killing containers, plus running scripts, are guarded by cooldown periods, exponential backoff, rate limiting, and verification delays. A premium AI layer called Cirdan connects to local models via Ollama for incident analysis and guided remediation. Access uses a local admin account with session protection and password rotation. The appliance generates and manages its own TLS certificate authority. Installation options include an automated script, manual Docker Compose, Proxmox VM, direct Proxmox host, and Unraid Community Apps. The codebase is open source under Apache-2.0 with a premium tier for advanced central and edge workflows.

Should you self-host logforge?

logforge scores 47/100 on selfhost.directory (how scoring works) and ranks #28 of 44 in Container Management. It has 302 GitHub stars.

It shipped 3 stable releases in the past year. The latest, V3.0.1, came out on 28 October 2026. New versions land roughly every 6 months.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is Apache-2.0-licensed.

Its closest alternative on selfhost.directory is Portainer (77/100, 38 735 stars). It scores higher overall, so compare the two before you pick. See logforge vs Portainer side by side.

Features

  • Container metrics and events
  • Custom alert rules
  • Encrypted sensitive configuration
  • File System Access
  • Local admin authentication
  • Multi-channel notifications
  • Real-time Docker log streaming
  • Remote host monitoring via agents
  • Safe automated remediation
  • Self-managed TLS certificate authority

logforge README

How to install logforge

Install logforge with Docker Compose

Docker Engine and Docker Compose plugin
Environment variables
UNICRON_CENTRAL_FQDN, UNICRON_APP_PORT, UNICRON_AGENT_MTLS_PORT, CENTRAL_ADMIN_USERNAME, CENTRAL_ADMIN_PASSWORD, CENTRAL_ADMIN_RECOVERY_OVERRIDE

git clone https://github.com/log-forge/logforge.git cd logforge docker compose pull docker compose up -d docker compose ps unicron

Manual deployment with explicit control over checkout, .env, and Compose commands

How to configure logforge

  • CENTRAL_ADMIN_PASSWORDLocal admin password (blank = auto-generated on first boot)

    Local admin password (blank = auto-generated on first boot)

    values: Any string

  • CENTRAL_ADMIN_RECOVERY_OVERRIDEfalseEnable recovery mode to rotate admin credentials

    Enable recovery mode to rotate admin credentials

    values: true, false

  • CENTRAL_ADMIN_USERNAMEadminLocal admin username

    Local admin username

    values: Any string

  • UNICRON_AGENT_MTLS_PORT9443Host port for Unicron-agent mTLS enrollment and traffic

    Host port for Unicron-agent mTLS enrollment and traffic

    values: 1-65535

  • UNICRON_APP_PORT8444Host port for browser and API access to /unicron

    Host port for browser and API access to /unicron

    values: 1-65535

  • UNICRON_CENTRAL_FQDNlocalhostServer's reachable DNS hostname for external access (e.g., logs.example.com)

    Server's reachable DNS hostname for external access (e.g., logs.example.com)

    values: Any valid DNS hostname

logforge releases & version history

More in Log Management

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…