theanig/goatcounter repository overview

⁠theanig/goatcounter

Personal repo for building and maintaining the Docker image for goatcounter⁠ - for simple web statistics.

Inspired off of baethon/goatcounter⁠ and anarcat/goatcounter⁠

Since that repo was archived, I created this repo to continue publishing newer versions of goatcounter in my containers.

⁠How to use this image

podman run --name goatcounter \
  -e GOATCOUNTER_DOMAIN=stats.domain.com \
  -e [email protected] \
  theanig/goatcounter

This command will start a single instance with pre-configured stats.domain.com site.

GOATCOUNTER_DOMAIN and GOATCOUNTER_EMAIL are mandatory.

⁠Environment Variables

⁠GOATCOUNTER_DOMAIN

This mandatory environment variable is used to create the initial site.

⁠GOATCOUNTER_EMAIL

This mandatory environment variable defines the e-mail address of the admin user.

It's used to create the initial site and is passed as an -auth option to the serve command.

⁠GOATCOUNTER_PASSWORD

This mandatory environment variable defines the password of the admin user.

⁠GOATCOUNTER_SMTP

This optional environment variable defines the SMTP server (e.g., smtp://user:[email protected]:587) which will be used by the server.

Default: stdout - print email contents to stdout

⁠GOATCOUNTER_DB

This optional environment variable defines the location of the database. By default, the server will use SQLite database which is recommended solution.

It's possible to use the Postgres DB however, the image was not tested against it.

Don't change this value unless you know what you're doing.

Default: sqlite:///goatcounter/db/goatconter.sqlite3

⁠Troubleshooting

⁠The server displays migration info

During startup, the container will try to execute all available migrations. What you see, is the output of goatcounter migrate command.

⁠line X: GOATCOUNTER_*: unbound variable

You forgot to set one of the mandatory env variables.

⁠zdb.TX fn: cname: already exists.

The entrypoint script tries to create the initial site on every container startup. Once it's created, the goatcounter create command will report this error. It's safe to ignore it.