Install


Requirements

Dokku

Shokku requires an underlying Dokku installation. You are recommended to manually install & configure it following the official documentation.

SSL

Shokku will only work over HTTPS, so SSL must be configured. This can be via:

  • Automatic (LetsEncrypt)
    If a global email has been set, it will automatically be used. Otherwise, ensure the SHOKKU_LETSENCRYPT_EMAIL environment variable is set during installation to a valid email.
  • Manual
    Set the SHOKKU_CERT environment variable to point to a tarball containing the certificate contents. Tarball creation instructions can be found here.

System Requirements

Please refer to the operating systems supported by Dokku.
Shokku is lightweight and will consume very little resources.

DigitalOcean

For a cheap hosted server to try Shokku out, consider using DigitalOcean via this referral link. I get a kickback, and you get $200 in credit for 60 days - why not provision something beefy :)

DigitalOcean Referral Badge

Install Using Script

wget "https://shokku.dev/bootstrap.sh"
export SHOKKU_LETSENCRYPT_EMAIL="foo@example.com"
bash bootstrap.sh

Manual Installation

Instructions

If you don't feel comfortable using some random script from the internet, the installation can be manually performed fairly easily.
Take a look at the bootstrap script, it is commented and easy to follow.