DEV Community

Cover image for Dokku the heroku alternative for solo developers
Ahmed Atalla
Ahmed Atalla

Posted on • Originally published at


Dokku the heroku alternative for solo developers

Heroku and free plan

In a blog post published at August 25, 2022 , Heroku general manager stated that they will stop offering free dynos dyno is heroku computing unit starting November, 28 2022, check the blog post and Remove free products plan

This decision will affect solo developers who use heroku to te st their ideas or host projects at early stage, and regarding to how easy it is to use heroku now we need an alternative


what is dokku ?

An open source PAAS alternative to Heroku.
Dokku helps you build and manage the lifecycle of applications from building to scaling.

Dokku is an extensible, open source Platform as a Service that runs on a single server of your choice. Dokku supports building apps on the fly from a git push via either Dockerfile or by auto-detecting the language with Buildpacks, and then starts containers based on your built image. Using technologies such as nginx and cron, Web processes are automatically routed to, while background processes and automated cron tasks are also managed by Dokku.

Getting started

Minimum requirement to run dokku are:

  • A fresh installation of Ubuntu 18.04/20.04/22.04 or Debian 10+ x64.
  • At least 1 GB of system memory.
  • Attaching at least one domain name to your server ip, say


  • First ssh into your remote server.
  • Download the installation script
Enter fullscreen mode Exit fullscreen mode
  • Run the installer script by prefixing with DOKKU_TaG=xxx env variable to specify which version you want, latest is better offcourse
 sudo DOKKU_TAG=v0.28.1 bash
Enter fullscreen mode Exit fullscreen mode
  • This command will automatically use apt to update and install dependecies such as docker, then it will created the required containers, also a new user dokku will be created

  • Next step is to add your public ssh key to be able to run dokku commands remotly, because dokku doesn't have a cli to install on your local machine like heroku toolbel

To add your key, get the content from your local machine, the key filename usually called

cat ~/.ssh/
Enter fullscreen mode Exit fullscreen mode

copy the file content and then on the remote server run this last command

echo "your-public-key-contents-here" | dokku ssh-keys:add admin
Enter fullscreen mode Exit fullscreen mode

once this is done, you can execute dokku commands remotly from your locall machine like this

ssh apps:List
ssh domains:report --global
Enter fullscreen mode Exit fullscreen mode
  • Now we need set the domain as a dokku global domain.
ssh domains:add-global

# check your setup
ssh domains:report --global

=====> Global domains information
       Domains global enabled:        true
       Domains global vhosts:
Enter fullscreen mode Exit fullscreen mode

with this done, any app you deploy will be available at by default unless you add another domain specific to the app

now you can create a new empty app like this

# From remote server shell
dokku apps:create my-first-application

# From your local machine
ssh dokku@<domain> apps:create my-second-app

Enter fullscreen mode Exit fullscreen mode

In the next article i will show you how to deploy a NextJS application to your server

Top comments (0)

🌚 Friends don't let friends browse without dark mode.

Sorry, it's true.