Introduction

Dokku is "the smallest PaaS" implementation (Platform as Service). It functions as a simplified version of heroku on Docker, allowing you to deploy your web apps through a simple git push.

Preparation

• A fresh installation of Ubuntu 16.04 x64, Ubuntu 14.04 x64, Debian 8.2 x64 or CentOS 7 x64 (experimental).
• The system should have FQDN setted
  • You can check this using command hostname
  • To set your hostname, use hostnamectl set-hostname YOUR_HOSTNAME
• The machine should have at least 1 GB memory
• Note: the newest official system requirements is here

Installation

Install Dokku

# for debian systems, installs Dokku via apt-get

wget https://raw.githubusercontent.com/dokku/dokku/v0.14.5/bootstrap.sh;
sudo DOKKU_TAG=v0.14.5 bash bootstrap.sh

Note: this installation may take 5-10 minutes

Setup SSH Key and Virtualhost Settings

Once the installatin is complete, visit your hostname or ip address to set up SSH Key and virtualhost for your dokku

Note: if you don't complete the set up via web installer, you should check by ps auxf | grep dokku-installer and close it using service dokku-installer stop or stop dokku-installer

Deploy first App

Deploying dokku apps are SUPER simple!

On your computer:

git remote add dokku dokku@YOUR_HOSTNAME:YOUR_APP_NAME
git push dokku master

After deployment, you should see your app deployed at http://YOUR_APP_NAME.YOUR_HOSTNAME

Reference

dokku official docs

Cover Photo by Javier Quesada