Home

Welcome to the docker-dokku wiki!

====

On MacOS X

1. Download and Install Vagrant Option A (Vagrant)

   1. a. Create a new folder << vagrant folder >> (such as ubuntu-docker)
   2. cd << vagrant folder >>
   3. vagrant init ubuntu/trusty64
   4. vi VagrantFile
   5. Pick an IP address for Vagrant (such as 10.88.0.8)
   6. change line config.vm.network "private_network", ip: "<< ip address >>"
   7. vagrant up

   Option B (EC2)

   1. Or, host of your choice

2. Install Docker and Dokku

   1. vagrant ssh
   2. sudo apt-get update
   3. sudo apt-get install docker
   4. sudo apt-get install daemontools
   5. sudo apt-get install build-essential
   6. sudo apt-get install libtool
   7. Install dokku: (needed to run it twice last time, maybe a transient problem)
      • wget -qO- https://raw.github.com/progrium/dokku/v0.3.12/bootstrap.sh | sudo DOKKU_TAG=v0.3.12 bash
   8. Update build-step
      • git clone https://github.com/progrium/buildstep.git
      • cd buildstep
      • git pull origin master
      • sudo make build
      • (reference: http://progrium.viewdocs.io/dokku/upgrading)
   9. Increase swap space: http://stackoverflow.com/a/22247782/1022903 (for non-Vagrant usage)

3. Config host machine

   1. Exit vagrant ssh shell
   2. Edit /etc/hosts to add line:
      • << ip address >> dokku.me
   3. cat ~/.ssh/id_rsa.pub | vagrant ssh dokku.me "sudo sshcommand acl-add dokku $USER"
      • (reference: https://github.com/progrium/dokku/blob/master/docs/installation.md)

4. Create a project and push

   1. git remote add dokkudev [email protected]:<< app name >>
   2. git push dokkudev master
   3. For each config:
      • dokkudev config:set << app name >> ...
   4. Or, ssh into vagrant cd << vagrant folder >> && vagrant ssh
      • And, edit ~dokku/<< app name >>ENV directly
      • ** remember to include export in front of each lines
      • dokku config:set << app name >> a=b # to cause config reload
   5. dokkudev logs << app name >>
   6. If error arise: setuidgid: fatal: unable to run failure, do step 2.5 ('daemontools')

5. Install plugins

   1. log into vagrant
   2. cd /var/etc/lib/dokku/plugins
   3. git clone https://github.com/dyson/dokku-docker-options
   4. cd /var/etc/lib
   5. git clone https://github.com/dokku-alt/dokku-alt.git
   6. cd /var/etc/lib/dokku/plugins
   7. ln -s /var/etc/lib/dokku-alt/plugins/dokku-mariadb/
   8. dokku plugins:install

6. Update MySQL

    FLUSH TABLES WITH READ LOCK;
    FLUSH LOGS;
    SET GLOBAL binlog_format = 'MIXED';
    FLUSH LOGS;
    UNLOCK TABLES;
    
    # http://dba.stackexchange.com/a/6753