docs/getting-started/upgrading.md

# Upgrading

If your version of Dokku is pre 0.3.0 (check with `dokku version`), we recommend [a fresh install](/docs/getting-started/installation.md) on a new server.

## Migration Guides

Before upgrading, check the migration guides to get comfortable with new features and prepare your deployment to be upgraded.

### 0.5 Migration Guide

- [0.5 Migration Guide](/docs/appendices/0.5.0-migration-guide.md)

### 0.6 Migration Guide

- [0.6 Migration Guide](/docs/appendices/0.6.0-migration-guide.md)

### 0.7 Migration Guide

- [0.7 Migration Guide](/docs/appendices/0.7.0-migration-guide.md)

### 0.8 Migration Guide

- [0.8 Migration Guide](/docs/appendices/0.8.0-migration-guide.md)

### 0.9 Migration Guide

- [0.9 Migration Guide](/docs/appendices/0.9.0-migration-guide.md)

### 0.10 Migration Guide

- [0.10 Migration Guide](/docs/appendices/0.10.0-migration-guide.md)

## Upgrade Instructions

If Dokku was installed via `apt-get install dokku` or `bootstrap.sh` (most common), upgrade with:

```shell
# update your local apt cache
sudo apt-get update

# stop each running app
# for 0.11.4 and newer versions, use
dokku ps:stopall
# for versions between 0.8.1 and 0.11.3, use
dokku --quiet apps:list | xargs -L1 dokku ps:stop
# for versions versions older than 0.8.1, use
dokku --quiet apps | xargs -L1 dokku ps:stop

# update dokku and it's dependencies
sudo apt-get install -qq -y dokku herokuish sshcommand plugn

# rebuild all of your applications
dokku ps:rebuildall # rebuilds all applications
```

> If you have any applications deployed via the `tags` or `tar` commands, do not run the `ps:rebuildall` command,
> and instead trigger `ps:rebuild` manually for each `git`-deployed application:
>
> ```
> dokku ps:rebuild APP
> ```
>
> Please see the [images documentation](/docs/deployment/methods/images.md) and [tar documentation](/docs/deployment/methods/tar.md)
> for instructions on rebuilding applications deployed by those plugins.

### Upgrade From Source

If you installed Dokku from source (less common), upgrade with:

```shell
dokku --quiet apps | xargs -L1 dokku ps:stop # stops each running app
cd ~/dokku
git pull --tags origin master

# continue to install from source
sudo DOKKU_BRANCH=master make install

# upgrade to debian package-based installation
sudo make install
dokku ps:rebuildall # rebuilds all applications
```

To upgrade herokuish from source, upgrade with:

```shell
cd /tmp
git clone https://github.com/gliderlabs/herokuish.git
cd herokuish
git pull origin master
IMAGE_NAME=gliderlabs/herokuish BUILD_TAG=latest VERSION=master make -e build-in-docker
```
Consolidate readme/wiki docs into organized docs folder 2014-10-04 04:24:22 -04:00			`# Upgrading`

docs: use urls that are linkable on github 2017-04-13 23:09:46 -06:00			If your version of Dokku is pre 0.3.0 (check with `dokku version`), we recommend [a fresh install](/docs/getting-started/installation.md) on a new server.
Consolidate readme/wiki docs into organized docs folder 2014-10-04 04:24:22 -04:00
Fix formatting on upgrading docs [ci skip] 2016-03-21 01:41:03 -04:00			`## Migration Guides`
Add link to 0.5.x migration guide [ci skip] 2016-03-02 23:10:05 -05:00
condense upgrading instructions + fix broken links 2016-04-20 15:32:52 -05:00			`Before upgrading, check the migration guides to get comfortable with new features and prepare your deployment to be upgraded.`
Add link to 0.5.x migration guide [ci skip] 2016-03-02 23:10:05 -05:00
Add a migration guide for 0.7.0 [ci skip] 2016-08-26 14:11:56 -04:00			`### 0.5 Migration Guide`

docs: use urls that are linkable on github 2017-04-13 23:09:46 -06:00			`- [0.5 Migration Guide](/docs/appendices/0.5.0-migration-guide.md)`
Add a migration guide for 0.7.0 [ci skip] 2016-08-26 14:11:56 -04:00
			`### 0.6 Migration Guide`

docs: use urls that are linkable on github 2017-04-13 23:09:46 -06:00			`- [0.6 Migration Guide](/docs/appendices/0.6.0-migration-guide.md)`
Add a migration guide for 0.7.0 [ci skip] 2016-08-26 14:11:56 -04:00
			`### 0.7 Migration Guide`

docs: use urls that are linkable on github 2017-04-13 23:09:46 -06:00			`- [0.7 Migration Guide](/docs/appendices/0.7.0-migration-guide.md)`
Update upgrading.md 2016-03-28 21:09:37 -05:00
docs: add links to migration guides [ci skip] 2017-08-09 17:07:06 -04:00			`### 0.8 Migration Guide`

			`- [0.8 Migration Guide](/docs/appendices/0.8.0-migration-guide.md)`

			`### 0.9 Migration Guide`

			`- [0.9 Migration Guide](/docs/appendices/0.9.0-migration-guide.md)`

			`### 0.10 Migration Guide`

			`- [0.10 Migration Guide](/docs/appendices/0.10.0-migration-guide.md)`

condense upgrading instructions + fix broken links 2016-04-20 15:32:52 -05:00			`## Upgrade Instructions`
Update upgrading.md 2016-03-28 21:09:37 -05:00
Use correct casing for Dokku name lowercase should only be used to refer to the binary, not the project 2016-09-03 04:39:12 -04:00			If Dokku was installed via `apt-get install dokku` or `bootstrap.sh` (most common), upgrade with:
Consolidate readme/wiki docs into organized docs folder 2014-10-04 04:24:22 -04:00
Use shell keyword for codeblock guard 2014-12-19 15:09:38 -05:00			```shell
docs: update uninstallation docs to clarify which subcommand to use for listing applications [ci skip] 2017-08-19 19:03:20 -04:00			`# update your local apt cache`
condense upgrading instructions + fix broken links 2016-04-20 15:32:52 -05:00			`sudo apt-get update`
docs: update uninstallation docs to clarify which subcommand to use for listing applications [ci skip] 2017-08-19 19:03:20 -04:00
			`# stop each running app`
Replace docs using manual stopping of all apps with ps:stopall cmd 2018-01-19 00:37:26 +08:00			`# for 0.11.4 and newer versions, use`
			`dokku ps:stopall`
			`# for versions between 0.8.1 and 0.11.3, use`
docs: update uninstallation docs to clarify which subcommand to use for listing applications [ci skip] 2017-08-19 19:03:20 -04:00			`dokku --quiet apps:list \| xargs -L1 dokku ps:stop`
Replace docs using manual stopping of all apps with ps:stopall cmd 2018-01-19 00:37:26 +08:00			`# for versions versions older than 0.8.1, use`
docs: update uninstallation docs to clarify which subcommand to use for listing applications [ci skip] 2017-08-19 19:03:20 -04:00			`dokku --quiet apps \| xargs -L1 dokku ps:stop`

			`# update dokku and it's dependencies`
docs: upgrade sshcommand and plugn as well [ci skip] 2016-11-27 19:55:02 -07:00			`sudo apt-get install -qq -y dokku herokuish sshcommand plugn`
docs: update uninstallation docs to clarify which subcommand to use for listing applications [ci skip] 2017-08-19 19:03:20 -04:00
			`# rebuild all of your applications`
Document caveats around ps:rebuild and tags/tar deployed applications. Closes #2374 The tags and tar plugins do not necessarily build from source, and running `ps:rebuild` can have some unexpected output in certain cases. Rather than try to handle that complexity - it's a lot - documenting the edge cases is the most appropriate way forward. 2016-09-06 20:26:53 -04:00			`dokku ps:rebuildall # rebuilds all applications`
Consolidate readme/wiki docs into organized docs folder 2014-10-04 04:24:22 -04:00			```

Document caveats around ps:rebuild and tags/tar deployed applications. Closes #2374 The tags and tar plugins do not necessarily build from source, and running `ps:rebuild` can have some unexpected output in certain cases. Rather than try to handle that complexity - it's a lot - documenting the edge cases is the most appropriate way forward. 2016-09-06 20:26:53 -04:00			> If you have any applications deployed via the `tags` or `tar` commands, do not run the `ps:rebuildall` command,
			> and instead trigger `ps:rebuild` manually for each `git`-deployed application:
			`>`
			> ```
			`> dokku ps:rebuild APP`
			> ```
			`>`
docs: use urls that are linkable on github 2017-04-13 23:09:46 -06:00			`> Please see the [images documentation](/docs/deployment/methods/images.md) and [tar documentation](/docs/deployment/methods/tar.md)`
Document caveats around ps:rebuild and tags/tar deployed applications. Closes #2374 The tags and tar plugins do not necessarily build from source, and running `ps:rebuild` can have some unexpected output in certain cases. Rather than try to handle that complexity - it's a lot - documenting the edge cases is the most appropriate way forward. 2016-09-06 20:26:53 -04:00			`> for instructions on rebuilding applications deployed by those plugins.`

condense upgrading instructions + fix broken links 2016-04-20 15:32:52 -05:00			`### Upgrade From Source`
Consolidate readme/wiki docs into organized docs folder 2014-10-04 04:24:22 -04:00
Use correct casing for Dokku name lowercase should only be used to refer to the binary, not the project 2016-09-03 04:39:12 -04:00			`If you installed Dokku from source (less common), upgrade with:`
Consolidate readme/wiki docs into organized docs folder 2014-10-04 04:24:22 -04:00
[ci skip] update upgrade documentation for 0.3.18 2015-04-18 02:48:44 -04:00			```shell
docs: use --quiet flag [ci skip] 2017-05-01 22:28:30 -06:00			`dokku --quiet apps \| xargs -L1 dokku ps:stop # stops each running app`
[ci skip] update upgrade documentation for 0.3.18 2015-04-18 02:48:44 -04:00			`cd ~/dokku`
			`git pull --tags origin master`
Consolidate readme/wiki docs into organized docs folder 2014-10-04 04:24:22 -04:00
[ci skip] update upgrade documentation for 0.3.18 2015-04-18 02:48:44 -04:00			`# continue to install from source`
			`sudo DOKKU_BRANCH=master make install`
Consolidate readme/wiki docs into organized docs folder 2014-10-04 04:24:22 -04:00
[ci skip] update upgrade documentation for 0.3.18 2015-04-18 02:48:44 -04:00			`# upgrade to debian package-based installation`
			`sudo make install`
Document caveats around ps:rebuild and tags/tar deployed applications. Closes #2374 The tags and tar plugins do not necessarily build from source, and running `ps:rebuild` can have some unexpected output in certain cases. Rather than try to handle that complexity - it's a lot - documenting the edge cases is the most appropriate way forward. 2016-09-06 20:26:53 -04:00			`dokku ps:rebuildall # rebuilds all applications`
[ci skip] update upgrade documentation for 0.3.18 2015-04-18 02:48:44 -04:00			```
Consolidate readme/wiki docs into organized docs folder 2014-10-04 04:24:22 -04:00
condense upgrading instructions + fix broken links 2016-04-20 15:32:52 -05:00			`To upgrade herokuish from source, upgrade with:`
Consolidate readme/wiki docs into organized docs folder 2014-10-04 04:24:22 -04:00
[ci skip] update upgrade documentation for 0.3.18 2015-04-18 02:48:44 -04:00			```shell
			`cd /tmp`
initial pass at switching to herokuish. closes #1091 2015-04-20 16:32:18 -07:00			`git clone https://github.com/gliderlabs/herokuish.git`
			`cd herokuish`
[ci skip] update upgrade documentation for 0.3.18 2015-04-18 02:48:44 -04:00			`git pull origin master`
[ci skip] remove unnecessary comments and update docs 2015-07-09 13:22:12 -07:00			`IMAGE_NAME=gliderlabs/herokuish BUILD_TAG=latest VERSION=master make -e build-in-docker`
[ci skip] update upgrade documentation for 0.3.18 2015-04-18 02:48:44 -04:00			```