diff --git a/docs/getting-started/uninstalling.md b/docs/getting-started/uninstalling.md new file mode 100644 index 000000000..d5c8bc379 --- /dev/null +++ b/docs/getting-started/uninstalling.md @@ -0,0 +1,54 @@ +# Uninstalling + +While we hate to see you go, if you need to uninstall Dokku, the following may help you out: + +## Arch Installation + +```shell +# purge dokku from your system +yaourt -Rsn dokku +``` + +## CentOS Installation + +```shell +# uninstall dokku +yum remove dokku herokuish +``` + +## Debian Installation + +```shell +# purge dokku from your system +apt-get purge -y --force-yes dokku herokuish + +# remove any dependencies that are no longer necessary +apt-get -y --force-yes autoremove +``` + +## Makefile Installation + +This is a manual deletion process, and as it is not a recommended installation method, there is currently no automated uninstallation. + +All service plugins should be unlinked from applications, stopped, and destroyed. + +All applications should be stopped, and all docker containers and images deleted: + +```shell +# stop all applications +dokku --quiet apps | xargs dokku ps:stop + +# cleanup containers and images +dokku cleanup +``` + +The following user/group must be deleted: + +- user: `dokku` +- group: `dokku` + +The following directories must be deleted: + +- `~dokku` +- `/var/lib/dokku` +- `/var/log/dokku` diff --git a/docs/template.html b/docs/template.html index 84b26c22f..ffc6ec793 100644 --- a/docs/template.html +++ b/docs/template.html @@ -111,6 +111,7 @@ Getting Started Getting Started with Dokku Upgrading Dokku + Uninstalling Dokku Troubleshooting Getting Help