dokku/docs/upgrading.md

Upgrading

Dokku is in active development. You can update the deployment step and the build step separately.

Note: If you are upgrading from a revision prior to 27d4bc8c3c, follow the instructions in this wiki entry.

To update the deploy step (this is updated less frequently):

cd ~/dokku
git pull origin master
sudo make install

Nothing needs to be restarted. Changes will take effect on the next push / deployment.

To update the build step:

git clone https://github.com/progrium/buildstep.git
cd buildstep
git pull origin master
sudo make build

This will build a fresh Ubuntu Quantal image, install a number of packages, and eventually replace the Docker image for buildstep.

Migrating from 0.1.0 to 0.2.0

This should be summary of breaking changes between 0.1 and 0.2 version with instructions to upgrade.

software-properties-common

software-properties-common is now dependency for plugins. Before running dokku install script, make sure it installed.

> sudo apt-get install software-properties-common

Gitreceive removed

PR #270.

Starting with Dokku 0.2.0, Gitrecieve is replaced by a gitplugin.

Dokku no longer uses the git user. Everything is done with the dokku user account.

This causes the remote url to change. Instead of pushing to git@hostname:app, you should now push to dokku@hostname:app. The url must be modified using the git remote set-url command :

git remote set-url deploy dokku@hostname:app

Where deploy is the name of the remote.

Additionally, the repositiories on the server must be migrated to work with dokku 0.2.0

There is upgrade script, which is meant to automate this migration. To use it:

1. run the script as root
2. git pull to get the latest version of dokku
3. make install
4. dokku deploy:all

TDB.

Cache directory

Commit #6350f373

Buildstep have to re-installed in order to support cache directory.

TDB.