Link Search Menu Expand Document

Downloads and distributions

Offen Fair Web Analytics is currently distributed in two ways: packaged as a single binary file for Linux, MacOS and Windows or as a Docker image. The most recent release is available here, Docker images are hosted on Docker Hub.

The latest binary tarball can be downloaded from https://get.offen.dev:

curl -sSL https://get.offen.dev -o offen.tar.gz

On Docker Hub, latest will give you the last release:

docker pull offen/offen:latest

For Ubuntu and Debian, we also provide a deb package you can download:

curl -sSL https://get.offen.dev/deb -o offen.deb

Table of contents

  1. Release channels
  2. Downloading binary files
  3. Verifying the binaries’ signatures
  4. Pulling the Docker image
  5. Click-To-Deploy
    1. Heroku
    2. DigitalOcean
    3. YunoHost
  6. Building Offen for other architectures other

Release channels

Both for binaries and Docker images you can use one of these channels to pick your download:

Tagged releases

In case you want to deploy Offen Fair Web Analytics, this channel is what you are most likely going to use. When ready, we cut official releases and tag them with a version identifier (e.g. v0.1.0). These releases are immutable and will never change, so both a download and the Docker image are guaranteed to provide the exact same build every time.

Development channel

The development channel gives you the most recent build from the development branch of our repository. This is likely to contain things that are not production ready or bring other kinds of caveats. Only binaries and Docker images are available for this channel. You probably should not use this unless you are participating in the development of Offen Fair Web Analytics.


Downloading binary files

Binary files can be downloaded from our GitHub repository or using get.offen.dev. The most recent release is available here.

Downloading https://get.offen.dev will give you a tarball containing the most recent tagged release. If you specify a version or channel like https://get.offen.dev/v0.1.0-alpha.8 you will download that specific version.

# most recent release
curl -sSL https://get.offen.dev
# most recent build from the development channel
curl -sSL https://get.offen.dev/development
# build for v1.3.4
curl -sSL https://get.offen.dev/v1.3.4

Heads Up

The archive file currently contains the binaries for all supported operating systems, so no matter which OS you are targeting, you will always download the same file.

Verifying the binaries’ signatures

To prevent unwanted modifications of our releases, we sign all binaries using GPG and include the signature in our distribution. You can run the following commands to verify the integrity of your download:

curl https://keybase.io/hioffen/pgp_keys.asc | gpg --import
gpg --verify offen-linux-amd64.asc offen-linux-amd64

Debian packages are also signed:

curl https://keybase.io/hioffen/pgp_keys.asc | gpg --import
dpkg-sig --verify offen.deb

Pulling the Docker image

Docker images are available as offen/offen on Docker Hub. Tagged releases are available under the respective tag (e.g. offen/offen:v0.1.0). The development channel is available as an image tag as well. As per Docker convention latest maps to the latest tagged release.

# v1.3.4 release
docker pull offen/offen:v1.3.4
# development channel
docker pull offen/offen:development

Heads Up

While our version tags on Docker Hub are immutable and will always return the same build, it is important to note that development and latest will be updated on a rolling basis. If you deploy Offen Fair Web Analytics using Docker, make sure to use a version tag or pin your image’s revision.


Click-To-Deploy

We currently also offer “Click-To-Deploy” packages for the following hosting providers:

Heroku

You can deploy Offen Fair Web Analytics to Heroku using our deployment template. We also offer a tutorial on this website.

DigitalOcean

Using Packer you can build our DigitalOcean image and use it to create a new Droplet running Offen Fair Web Analytics.

YunoHost

If you use YunoHost to self-host your applications, you can install our packaged Offen app to get Offen Fair Web Analytics up and running:

$ sudo yunohost app install https://github.com/offen/offen_ynh

Building Offen for other architectures other

Current distributions of Offen Fair Web Analytics target amd64, arm64 and arm/v7 architectures only. If you want to run it on different hardware, it is possible to build a binary for your target OS and platform yourself. Assuming you have Docker and make installed, you can build the latest version like this (the example targets Linux on ARM v6):

git clone git@github.com:offen/offen.git
cd offen
git checkout v1.3.4
TARGETS=linux/arm-6 make build

Once finished, the bin folder contains your binary of choice. Currently supported architectures are all architectures supported by xgo:

  • 386
  • amd64
  • arm-5
  • arm-6
  • arm-7
  • arm64
  • mips
  • mipsle
  • mips64
  • mips64le

Supported operating systems are:

  • linux
  • darwin
  • windows