Dokku: Open source Heroku alternative

Dokku is a self-hosted open-source PaaS similar to Heroku.

My favorite hosting solution for several years. It’s lightweight, open-source and really stable. There are two general modes of operation: Buildpacks (e.g. Herokuish) and Dockerfiles.

On a freshly installed Linux machine, after installing Dokku you can push to Git repos on the server, and a container will be built and started for your app, with Nginx as a reverse proxy running in front of everything.

Installation

Linux (Debian/Ubuntu)

# download the installation script
wget -NP . https://dokku.com/bootstrap.sh

# run the installer
sudo bash bootstrap.sh

Mac (Homebrew)

brew install dokku/repo/dokku

Plugins

dokku-letsencrypt - Automatic Let’s Encrypt TLS Certificate installation
dokku-mariadb - MariaDB plugin
dokku-postgres - PostgreSQL plugin
dokku-redirect - Simple redirects for applications

Plugins are installed from the server with:

sudo dokku plugin:install https://github.com/dokku/dokku-letsencrypt.git

Deploying an app

Create the app on the server:

dokku apps:create myapp

Then, from your local repo, add the server as a Git remote and push:

git remote add dokku dokku@your-server.example.com:myapp
git push dokku main

Let’s Encrypt

After the app is reachable on its domain:

dokku letsencrypt:set myapp email you@example.com
dokku letsencrypt:enable myapp

General config settings

Change deploy branch

dokku git:set deploy-branch main

Timezone

dokku config:set TZ=Europe/Berlin

Nginx settings

Disable HSTS header

dokku nginx:set hsts false
dokku proxy:build-config

Max upload size

dokku nginx:set sitename client-max-body-size 25m

Rate limiting

See Rate limiting with dokku

Redirects

Redirect www to non-www using dokku-redirect plugin:

dokku redirect:set larsp www.larsp.de larsp.de
# -----> Configuring redirect for www.larsp.de to larsp.de via HTTP 301...

Ruby on Rails

Rails config

dokku config:set myrailsapp \
  SECRET_KEY_BASE=mysecret RAILS_ENV=production \
  RACK_ENV=production RAILS_LOG_TO_STDOUT=enabled \
  RAILS_SERVE_STATIC_FILES=enabled

PHP

Troubleshooting buildpack error

In case there is a problem with the PHP buildpack:

/tmp/buildpacks/08_buildpack-php/bin/compile: line 236: /tmp/buildpacks/08_buildpack-php/support/build/_util/formulae-hash.sh: No such file or directory

Reset the PHP herokuish buildpack:

rm -rf /home/dokku/<app>/cache/*
dokku config:set <app> BUILDPACK_URL=https://github.com/heroku/heroku-buildpack-php --no-restart
dokku ps:rebuild <app>