Skip to content

Install Dokku using Vagrant

  • Download and install VirtualBox
  • Download and install Vagrant
  • Clone Dokku

    git clone https://github.com/dokku/dokku.git
    
  • Create VM

    # Optional ENV arguments:
    # - `BOX_NAME`
    # - `BOX_URI`
    # - `BOX_MEMORY`
    # - `DOKKU_DOMAIN`
    # - `DOKKU_IP`
    # - `FORWARDED_PORT`.
    cd path/to/dokku
    vagrant up
    

  • Setup SSH Config in ~/.ssh/config. The port listed here is usually correct, though you may want to verify that it is the same as the one listed in the output of vagrant ssh-config dokku

    Host dokku.me
        Port 22
    
  • Copy your SSH key via cat ~/.ssh/id_rsa.pub | pbcopy and paste it into the dokku-installer at http://dokku.me . Change the Hostname field on the Dokku Setup screen to your domain and then check the box that says Use virtualhost naming. Then click Finish Setup to install your key. You'll be directed to application deployment instructions from here.

Please note, the dokku.me domain is setup to point to 10.0.0.2 along with all subdomains (ie yourapp.dokku.me). If you change the DOKKU_IP in your vagrant setup you'll need to update your /etc/hosts file to point your reconfigured ip address.

You are now ready to deploy an app or install plugins.