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 theSHOKKU_LETSENCRYPT_EMAIL
environment variable is set during installation to a valid email. - Manual
Set theSHOKKU_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 :)
Install Using Script
wget "https://shokku.dev/bootstrap.sh"
export SHOKKU_LETSENCRYPT_EMAIL="foo@example.com"
bash bootstrap.sh
Manual Installation
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.