Downloads

Installation

Installing GoAccess is pretty easy. Just download, extract and compile it with:

					$ wget https://tar.goaccess.io/goaccess-1.9.3.tar.gz
					$ tar -xzvf goaccess-1.9.3.tar.gz
					$ cd goaccess-1.9.3/
					$ ./configure --enable-utf8 --enable-geoip=mmdb
					$ make
					# make install
				

Note: The only dependency is ncurses.
Note: You may need to install build tools like gcc, autoconf, gettext, autopoint etc for compiling/building software from source. e.g., base-devel, build-essential, "Development Tools".
Info: If outputting real-time HTML, ensure port 7890 is opened. See more details.

Configure Options

Multiple options can be used to configure GoAccess. For a complete up- to-date list of configure options, run ./configure --help

--enable-debug

Compile with debugging symbols and turn off compiler optimizations.

--enable-asan

Enable Address Sanitizer for debugging purposes.

--enable-utf8

Compile with wide character support. Ncursesw is required.

--enable-geoip=<legacy|mmdb>

Compile with GeoLocation support. MaxMind's GeoIP is required. legacy will utilize the original GeoIP databases. mmdb will utilize the enhanced GeoIP2 databases.

--with-getline

Dynamically expands line buffer in order to parse full line requests instead of using a fixed size buffer of 4096.

--with-openssl

Compile GoAccess with OpenSSL support for its WebSocket server.

Note: Support for libssl1.1 has been added upstream.

Distributions

It is easiest to install GoAccess on Linux using the preferred package manager of your Linux distribution. Please note that not all distributions will have the latest version of GoAccess available

Debian/Ubuntu

					# apt-get install goaccess
				

Note: This may not always give you the latest stable version. To make sure that you're running the latest stable version of GoAccess see option below.

Official GoAccess' Debian/Ubuntu Repository

$ wget -O - https://deb.goaccess.io/gnugpg.key | gpg --dearmor | sudo tee /usr/share/keyrings/goaccess.gpg >/dev/null
$ echo "deb [signed-by=/usr/share/keyrings/goaccess.gpg arch=$(dpkg --print-architecture)] https://deb.goaccess.io/ $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/goaccess.list
$ sudo apt-get update
$ sudo apt-get install goaccess

Fedora

					# yum install goaccess
				

Arch Linux

					# pacman -S goaccess
				

Gentoo

					# emerge net-analyzer/goaccess
				

OS X / Homebrew

					# brew install goaccess
				

Note: If GeoIP is needed, append --with-libmaxminddb to the command above. You will need to download the City/Country database from MaxMind and use the option --geoip-database to specify the database.

FreeBSD

					# pkg install sysutils/goaccess
				

OpenBSD

					# pkg_add goaccess
				

OpenSUSE

					# zypper ar -f obs://server:http http
					# zypper in goaccess
				

pkgsrc (NetBSD, Solaris, SmartOS, ...)

					# pkgin install goaccess
				

Slackware

					# curl https://slackbuilds.org/slackbuilds/14.1/system/goaccess.tar.gz | tar xvz
					# cd goaccess/
					# GEOIP=yes ./goaccess.SlackBuild
				

Windows

GoAccess can be used in Windows through Cygwin. See packages to install.

Docker

A Docker image has been updated, capable of directing output from an access log. If you only want to output a report, you can pipe a log from the external environment to a Docker-based process:

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

Or for a real-time report:

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

For more details, please see the Docker section on README.md file

Distribution Packages

GoAccess has minimal requirements, it's written in C and requires only ncurses. However, below is a table of some optional dependencies in some distros to build GoAccess from source.

Build from GitHub (Development)

					$ git clone https://github.com/allinurl/goaccess.git
					$ cd goaccess
					$ autoreconf -fi
					$ ./configure --enable-utf8 --enable-geoip=mmdb
					$ make
					# make install