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.

GoAccess logo

Self-host GoAccess

v1.12

Real-time web log analyzer with terminal and HTML dashboard

ReleaseOpen SourceMIT
Updated3 weeks ago
LanguageC
Setup difficultyModerate
Stars
21 131
Port
7890 (WebSocket server for real-time HTML output)
Docker
allinurl/goaccess
Install with Docker
GoAccess terminal dashboard showing real-time metricsGoAccess HTML dashboard with web-based interface

What is GoAccess?

GoAccess is an open-source tool that analyzes web server logs in real time, displaying results either directly in a terminal via ncurses or through a browser-based HTML dashboard. It helps administrators monitor traffic patterns, spot security issues like brute-force attacks, and diagnose performance problems. The software parses numerous log formats including Apache Combined Log Format, Nginx, Amazon S3, CloudFront, Caddy, and Traefik. Results can be exported as static HTML, streaming HTML via WebSocket, JSON, or CSV. It runs on any *nix system where you can install from source or use official Docker images, plus packages for most major Linux distributions.

GoAccess alternatives

Should you self-host GoAccess?

GoAccess scores 75/100 on selfhost.directory (how scoring works) and ranks #1 of 52 in Monitoring & observability. It has 21 131 GitHub stars, +117 in the last 30 days.

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is MIT-licensed and written mostly in C.

Its closest alternative on selfhost.directory is LibreNMS (72/100, 5 009 stars). GoAccess scores higher overall. See GoAccess vs LibreNMS side by side.

Features

  • ASN mappingrequires GeoIP2 database
  • Bot and crawler classification
  • GeoLocation supportrequires --enable-geoip at compile time
  • HTML dashboard with WebSocket streaming
  • Incremental log processing
  • Multiple log format support
  • Real-time terminal dashboard
  • TLS/SSL reporting
  • WebSocket authentication

GoAccess README

GoAccess C build GoAccess

What is it?

GoAccess is an open source, real-time web log analyzer and interactive viewer that runs in a terminal on *nix systems or directly in your browser. Designed with system administrators, DevOps engineers, and security professionals in mind, it delivers fast, actionable HTTP statistics and visual server reports on the fly. GoAccess parses your web server logs in real time and presents the data directly in the terminal or via a live HTML dashboard, making it easy to monitor traffic, detect anomalies, and troubleshoot issues instantly.

How to install GoAccess

Install GoAccess with Docker

Docker

touch report.html cat access.log | docker run --rm -i -v ./report.html:/report.html -e LANG=$LANG allinurl/goaccess -a -o report.html --log-format COMBINED -

OR real-time: tail -F access.log | docker run -p 7890:7890 --rm -i -e LANG=$LANG allinurl/goaccess -a -o report.html --log-format COMBINED --real-time-html -

Official image: allinurl/goaccess

How to configure GoAccess

  • --ws-auth-expire=<secs>8 hours (28800 seconds)Set JWT expiry time for WebSocket authentication

    values: "3600" → 3600 seconds, "120s" → 2 minutes, "24h" → 24 hours, "10m" → 10 minutes, "10d" → 10 days

  • --ws-auth-url=<url>URL where GoAccess fetches the initial JWT via a GET request
  • --tz=<timezone>Output report date/time data in the given canonical timezone name

    values: e.g., Europe/Berlin, America/Chicago, Africa/Cairo

  • --max-items=<num>366 items (or 50 in real-time HTML)Maximum number of items to display per panel

    values: 1 to n

  • --html-refresh=<seconds>1 secondRefresh the HTML report every X seconds

    values: 1–60

FAQ

How do I stay updated on new releases?

Follow Twitter @goaccess or use official Debian repo for updates. See official deb repo at https://goaccess.io/download#official-repo

How to make the HTML report work with Content Security Policy?

Set Content-Security-Policy with unsafe-inline and unsafe-eval: "script-src 'self' 'unsafe-inline' 'unsafe-eval'; style-src 'self' 'unsafe-inline'"

How do I generate a real-time HTML report?

Add `--real-time-html` flag: `goaccess access.log -o /path/report.html --real-time-html`. Connects via WebSocket to host name where report runs. Can specify with `--ws-url=<host>`.

How do I generate a static HTML report?

Run against web log file with `-a`: `goaccess /var/log/apache2/access.log -a -o report.html`

Where is the configuration file located?

Configuration file location: ~/.goaccessrc or %sysconfdir%/goaccess.conf (usually /etc/, /usr/etc/ or /usr/local/etc/). Pass --dcf to display actual path.

What's the memory footprint of GoAccess?

GoAccess footprint for 3,397,814 parsed lines is approximately 134.1 MiB with full features enabled. Removing query strings with -q can greatly decrease memory consumption.

How fast is GoAccess when parsing a log file?

Performance depends on processor, RAM, log size, etc. On an i7-8700K with 16GB RAM: ~101,245 lines/second with default hash tables, ~100,502 lines/second with full features enabled.

More in Monitoring & observability

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…