8f1b142949
# History ## 0.25.0 Install/update via the bootstrap script: ```shell wget https://raw.githubusercontent.com/dokku/dokku/v0.25.0/bootstrap.sh sudo DOKKU_TAG=v0.25.0 bash bootstrap.sh ``` See the [0.25.0 migration guide](/docs/appendices/0.25.0-migration-guide.md) for more information on migrating to 0.25.0. ### Bug Fixes - #4733: @josegonzalez Force grep to run in quiet mode in domains:add call - #4732: @josegonzalez Ensure image cleanup does not impact the stack image and refactor container/image cleanup - #4731: @josegonzalez Respect debconf selections where possible - #4729: @josegonzalez Correct count check for user-auth trigger - #4721: @josegonzalez Recursively sync submodules - #4717: @josegonzalez Silence stderr when checking for ufw on debian systems - #4716: @josegonzalez Suppress dos2unix stderr output during Dockerfile builds - #4686: @josegonzalez Ensure repository is bare when calling git:sync - #4684: @josegonzalez Install gpg-agent in bootstrap script - #4683: @josegonzalez Strip published port flags when triggering deploy tasks - #4651: @josegonzalez Do not attempt to retire when there was no pre-existing container - #4639: @josegonzalez Correct path for azure-vm releases ### New Features - #4730: @josegonzalez Execute motd at the end of the install - #4719: @josegonzalez Add support for routing an app to a specified host:port - #4715: @josegonzalez Switch from xip.io to sslip.io - #4460: @josegonzalez Implement registry plugin - #4711: @josegonzalez Enable installing on RPM systems where bind-utils is bindutils - #4687: @josegonzalez Output message explaining how to remove a deploy lock when a lock is encountered - #4682: @josegonzalez Properly space report output - #4502: @josegonzalez Add monorepo support - #4509: @josegonzalez Add ability to specify initial network - #4641: @dbazile Add initial support for installing onto Fedora ### Refactors - #4508: @josegonzalez Add support for the formation key in app.json - #4507: @josegonzalez Drop support for Ubuntu 16.04 ### Documentation - #4723: @josegonzalez Clarify buildkit instructions - #4718: @josegonzalez Update link to azure installation on homepage - #4714: @josegonzalez Swap from freenode to libera.chat - #4712: @josegonzalez Clarify the shape of the command that should be entered in app.json for a cron task - #4709: @josegonzalez Add migration note for deprecation of ubuntu 16.04 - #4697: @josegonzalez Specify that run containers use the same image - #4688: @josegonzalez Add a note on recovering networks - #4689: @josegonzalez Add a note about wildcards in the installation doc page - #4680: @josegonzalez Cleanup markdown lint errors - #4679: @josegonzalez Cleanup markdown lint errors - #4678: @josegonzalez Cleanup markdown lint errors - #4677: @josegonzalez Cleanup markdown lint errors - #4672: @bjab Fix typo in pack builder docs - #4668: @RealOrangeOne Make example gitlab-ci script a list - #4673: @eltociear Fix comment typo in dokku binary - #4661: @dy3l Fix case style - #4647: @AngCosmin Fixed unable to find version `v1` for official Github Action ### Tests - #4693: @josegonzalez Add package.lock for test app - #4685: @josegonzalez Remove ci skip note in PULL_REQUEST_TEMPLATE.md - #4681: @josegonzalez Ignore duplication warnings in codacy - #4644: @josegonzalez Update unit test publisher to latest ### Other - #4726: @josegonzalez Drop web installer in favor of setup via cli - #4713: @josegonzalez Make heroku-20/focal the default stack for herokuish builds - #4707: @dependabot[bot] chore(deps-dev): bump heroku/heroku-buildpack-php from 195 to 196 in /tests/apps/php - #4701: @josegonzalez Revamp dokku run command - #4671: @dependabot[bot] chore(deps-dev): bump heroku/heroku-buildpack-php from 193 to 195 in /tests/apps/php - #4674: @dependabot[bot] chore(deps): bump jetty-servlet from 11.0.5 to 11.0.6 in /tests/apps/java - #4652: @dependabot[bot] chore(deps): bump jetty-servlet from 11.0.4 to 11.0.5 in /tests/apps/java - #4653: @dependabot[bot] chore(deps): bump maven-dependency-plugin from 3.1.2 to 3.2.0 in /tests/apps/java - #4648: @dependabot[bot] chore(deps): bump django from 3.1.9 to 3.1.12 in /tests/apps/dockerfile-release - #4645: @dependabot[bot] chore(deps): bump jetty-servlet from 11.0.3 to 11.0.4 in /tests/apps/java - #4642: @dependabot[bot] chore(deps-dev): bump heroku/heroku-buildpack-php from 192 to 193 in /tests/apps/php
130 lines
12 KiB
Markdown
130 lines
12 KiB
Markdown
# Dokku
|
|
|
|
[](https://github.com/dokku/dokku/actions?query=workflow%3ACI)
|
|
[](https://packagecloud.io/dokku/dokku)
|
|
[](https://aur.archlinux.org/packages/dokku/)
|
|
[](https://glider-slackin.herokuapp.com/)
|
|
[](https://dokku.com/docs/getting-started/installation/)
|
|
[](#sponsors)
|
|
[](#backers)
|
|
[](https://www.patreon.com/dokku/)
|
|
|
|
Docker powered mini-Heroku. The smallest PaaS implementation you've ever seen.
|
|
|
|
## Sponsors
|
|
|
|
Become a sponsor and get your logo on our README on GitHub with a link to your site. [[Become a sponsor](https://opencollective.com/dokku#sponsor)]
|
|
|
|
<a href="https://opencollective.com/dokku/sponsor/0/website" target="_blank"><img src="https://opencollective.com/dokku/sponsor/0/avatar.svg"></a>
|
|
<a href="https://opencollective.com/dokku/sponsor/1/website" target="_blank"><img src="https://opencollective.com/dokku/sponsor/1/avatar.svg"></a>
|
|
<a href="https://opencollective.com/dokku/sponsor/2/website" target="_blank"><img src="https://opencollective.com/dokku/sponsor/2/avatar.svg"></a>
|
|
<a href="https://opencollective.com/dokku/sponsor/3/website" target="_blank"><img src="https://opencollective.com/dokku/sponsor/3/avatar.svg"></a>
|
|
<a href="https://opencollective.com/dokku/sponsor/4/website" target="_blank"><img src="https://opencollective.com/dokku/sponsor/4/avatar.svg"></a>
|
|
<a href="https://opencollective.com/dokku/sponsor/5/website" target="_blank"><img src="https://opencollective.com/dokku/sponsor/5/avatar.svg"></a>
|
|
<a href="https://opencollective.com/dokku/sponsor/6/website" target="_blank"><img src="https://opencollective.com/dokku/sponsor/6/avatar.svg"></a>
|
|
<a href="https://opencollective.com/dokku/sponsor/7/website" target="_blank"><img src="https://opencollective.com/dokku/sponsor/7/avatar.svg"></a>
|
|
<a href="https://opencollective.com/dokku/sponsor/8/website" target="_blank"><img src="https://opencollective.com/dokku/sponsor/8/avatar.svg"></a>
|
|
<a href="https://opencollective.com/dokku/sponsor/9/website" target="_blank"><img src="https://opencollective.com/dokku/sponsor/9/avatar.svg"></a>
|
|
<a href="https://opencollective.com/dokku/sponsor/10/website" target="_blank"><img src="https://opencollective.com/dokku/sponsor/10/avatar.svg"></a>
|
|
<a href="https://opencollective.com/dokku/sponsor/11/website" target="_blank"><img src="https://opencollective.com/dokku/sponsor/11/avatar.svg"></a>
|
|
<a href="https://opencollective.com/dokku/sponsor/12/website" target="_blank"><img src="https://opencollective.com/dokku/sponsor/12/avatar.svg"></a>
|
|
<a href="https://opencollective.com/dokku/sponsor/13/website" target="_blank"><img src="https://opencollective.com/dokku/sponsor/13/avatar.svg"></a>
|
|
<a href="https://opencollective.com/dokku/sponsor/14/website" target="_blank"><img src="https://opencollective.com/dokku/sponsor/14/avatar.svg"></a>
|
|
<a href="https://opencollective.com/dokku/sponsor/15/website" target="_blank"><img src="https://opencollective.com/dokku/sponsor/15/avatar.svg"></a>
|
|
<a href="https://opencollective.com/dokku/sponsor/16/website" target="_blank"><img src="https://opencollective.com/dokku/sponsor/16/avatar.svg"></a>
|
|
<a href="https://opencollective.com/dokku/sponsor/17/website" target="_blank"><img src="https://opencollective.com/dokku/sponsor/17/avatar.svg"></a>
|
|
<a href="https://opencollective.com/dokku/sponsor/18/website" target="_blank"><img src="https://opencollective.com/dokku/sponsor/18/avatar.svg"></a>
|
|
<a href="https://opencollective.com/dokku/sponsor/19/website" target="_blank"><img src="https://opencollective.com/dokku/sponsor/19/avatar.svg"></a>
|
|
<a href="https://opencollective.com/dokku/sponsor/20/website" target="_blank"><img src="https://opencollective.com/dokku/sponsor/20/avatar.svg"></a>
|
|
<a href="https://opencollective.com/dokku/sponsor/21/website" target="_blank"><img src="https://opencollective.com/dokku/sponsor/21/avatar.svg"></a>
|
|
<a href="https://opencollective.com/dokku/sponsor/22/website" target="_blank"><img src="https://opencollective.com/dokku/sponsor/22/avatar.svg"></a>
|
|
<a href="https://opencollective.com/dokku/sponsor/23/website" target="_blank"><img src="https://opencollective.com/dokku/sponsor/23/avatar.svg"></a>
|
|
<a href="https://opencollective.com/dokku/sponsor/24/website" target="_blank"><img src="https://opencollective.com/dokku/sponsor/24/avatar.svg"></a>
|
|
<a href="https://opencollective.com/dokku/sponsor/25/website" target="_blank"><img src="https://opencollective.com/dokku/sponsor/25/avatar.svg"></a>
|
|
<a href="https://opencollective.com/dokku/sponsor/26/website" target="_blank"><img src="https://opencollective.com/dokku/sponsor/26/avatar.svg"></a>
|
|
<a href="https://opencollective.com/dokku/sponsor/27/website" target="_blank"><img src="https://opencollective.com/dokku/sponsor/27/avatar.svg"></a>
|
|
<a href="https://opencollective.com/dokku/sponsor/28/website" target="_blank"><img src="https://opencollective.com/dokku/sponsor/28/avatar.svg"></a>
|
|
<a href="https://opencollective.com/dokku/sponsor/29/website" target="_blank"><img src="https://opencollective.com/dokku/sponsor/29/avatar.svg"></a>
|
|
|
|
## Backers
|
|
|
|
Support us with a monthly donation and help us continue our activities. [[Become a backer](https://opencollective.com/dokku#backer)]
|
|
|
|
<a href="https://opencollective.com/dokku/backer/0/website" target="_blank"><img src="https://opencollective.com/dokku/backer/0/avatar.svg"></a>
|
|
<a href="https://opencollective.com/dokku/backer/1/website" target="_blank"><img src="https://opencollective.com/dokku/backer/1/avatar.svg"></a>
|
|
<a href="https://opencollective.com/dokku/backer/2/website" target="_blank"><img src="https://opencollective.com/dokku/backer/2/avatar.svg"></a>
|
|
<a href="https://opencollective.com/dokku/backer/3/website" target="_blank"><img src="https://opencollective.com/dokku/backer/3/avatar.svg"></a>
|
|
<a href="https://opencollective.com/dokku/backer/4/website" target="_blank"><img src="https://opencollective.com/dokku/backer/4/avatar.svg"></a>
|
|
<a href="https://opencollective.com/dokku/backer/5/website" target="_blank"><img src="https://opencollective.com/dokku/backer/5/avatar.svg"></a>
|
|
<a href="https://opencollective.com/dokku/backer/6/website" target="_blank"><img src="https://opencollective.com/dokku/backer/6/avatar.svg"></a>
|
|
<a href="https://opencollective.com/dokku/backer/7/website" target="_blank"><img src="https://opencollective.com/dokku/backer/7/avatar.svg"></a>
|
|
<a href="https://opencollective.com/dokku/backer/8/website" target="_blank"><img src="https://opencollective.com/dokku/backer/8/avatar.svg"></a>
|
|
<a href="https://opencollective.com/dokku/backer/9/website" target="_blank"><img src="https://opencollective.com/dokku/backer/9/avatar.svg"></a>
|
|
<a href="https://opencollective.com/dokku/backer/10/website" target="_blank"><img src="https://opencollective.com/dokku/backer/10/avatar.svg"></a>
|
|
<a href="https://opencollective.com/dokku/backer/11/website" target="_blank"><img src="https://opencollective.com/dokku/backer/11/avatar.svg"></a>
|
|
<a href="https://opencollective.com/dokku/backer/12/website" target="_blank"><img src="https://opencollective.com/dokku/backer/12/avatar.svg"></a>
|
|
<a href="https://opencollective.com/dokku/backer/13/website" target="_blank"><img src="https://opencollective.com/dokku/backer/13/avatar.svg"></a>
|
|
<a href="https://opencollective.com/dokku/backer/14/website" target="_blank"><img src="https://opencollective.com/dokku/backer/14/avatar.svg"></a>
|
|
<a href="https://opencollective.com/dokku/backer/15/website" target="_blank"><img src="https://opencollective.com/dokku/backer/15/avatar.svg"></a>
|
|
<a href="https://opencollective.com/dokku/backer/16/website" target="_blank"><img src="https://opencollective.com/dokku/backer/16/avatar.svg"></a>
|
|
<a href="https://opencollective.com/dokku/backer/17/website" target="_blank"><img src="https://opencollective.com/dokku/backer/17/avatar.svg"></a>
|
|
<a href="https://opencollective.com/dokku/backer/18/website" target="_blank"><img src="https://opencollective.com/dokku/backer/18/avatar.svg"></a>
|
|
<a href="https://opencollective.com/dokku/backer/19/website" target="_blank"><img src="https://opencollective.com/dokku/backer/19/avatar.svg"></a>
|
|
<a href="https://opencollective.com/dokku/backer/20/website" target="_blank"><img src="https://opencollective.com/dokku/backer/20/avatar.svg"></a>
|
|
<a href="https://opencollective.com/dokku/backer/21/website" target="_blank"><img src="https://opencollective.com/dokku/backer/21/avatar.svg"></a>
|
|
<a href="https://opencollective.com/dokku/backer/22/website" target="_blank"><img src="https://opencollective.com/dokku/backer/22/avatar.svg"></a>
|
|
<a href="https://opencollective.com/dokku/backer/23/website" target="_blank"><img src="https://opencollective.com/dokku/backer/23/avatar.svg"></a>
|
|
<a href="https://opencollective.com/dokku/backer/24/website" target="_blank"><img src="https://opencollective.com/dokku/backer/24/avatar.svg"></a>
|
|
<a href="https://opencollective.com/dokku/backer/25/website" target="_blank"><img src="https://opencollective.com/dokku/backer/25/avatar.svg"></a>
|
|
<a href="https://opencollective.com/dokku/backer/26/website" target="_blank"><img src="https://opencollective.com/dokku/backer/26/avatar.svg"></a>
|
|
<a href="https://opencollective.com/dokku/backer/27/website" target="_blank"><img src="https://opencollective.com/dokku/backer/27/avatar.svg"></a>
|
|
<a href="https://opencollective.com/dokku/backer/28/website" target="_blank"><img src="https://opencollective.com/dokku/backer/28/avatar.svg"></a>
|
|
<a href="https://opencollective.com/dokku/backer/29/website" target="_blank"><img src="https://opencollective.com/dokku/backer/29/avatar.svg"></a>
|
|
|
|
## Requirements
|
|
|
|
A fresh VM running any of the following operating systems:
|
|
|
|
- Ubuntu 18.04/20.04 x64 - Any currently supported release
|
|
- Debian 9+ x64
|
|
- CentOS 7 x64 *(experimental)*
|
|
- Arch Linux x64 *(experimental)*
|
|
|
|
An SSH keypair that can be used for application deployment. If this exists before installation, it will be automatically imported into dokku.
|
|
Otherwise, you will need to import the keypair manually after installation using `dokku ssh-keys:add`.
|
|
|
|
## Installation
|
|
|
|
To install the latest stable release, run the following commands as a user who has access to `sudo`:
|
|
|
|
```shell
|
|
wget https://raw.githubusercontent.com/dokku/dokku/v0.25.0/bootstrap.sh
|
|
sudo DOKKU_TAG=v0.25.0 bash bootstrap.sh
|
|
```
|
|
|
|
You can then proceed to the ip address or domain name associated with your server to complete the web-based installation.
|
|
|
|
If you wish for a more unattended installation method, see [these](https://dokku.com/docs/getting-started/install/debian/#unattended-installation) docs.
|
|
|
|
### Upgrade
|
|
|
|
[View the docs](https://dokku.com/docs/getting-started/upgrading/) for upgrading from an older version of Dokku.
|
|
|
|
## Documentation
|
|
|
|
Full documentation - including advanced installation docs - are available online at [https://dokku.com/docs/getting-started/installation/](https://dokku.com/docs/getting-started/installation/).
|
|
|
|
## Support
|
|
|
|
You can use [GitHub Issues](https://github.com/dokku/dokku/issues), check [Troubleshooting](https://dokku.com/docs/getting-started/troubleshooting/) in the documentation, or join us on [Gliderlabs Slack in the #dokku channel](https://glider-slackin.herokuapp.com/).
|
|
|
|
## Contribution
|
|
|
|
After checking [GitHub Issues](https://github.com/dokku/dokku/issues), the [Troubleshooting Guide](https://dokku.com/docs/getting-started/troubleshooting/) or having a chat with us on [Gliderlabs Slack in the #dokku channel](https://glider-slackin.herokuapp.com/), feel free to fork and create a Pull Request.
|
|
|
|
While we may not merge your PR as is, they serve to start conversations and improve the general Dokku experience for all users.
|
|
|
|
## License
|
|
|
|
[MIT License](https://github.com/dokku/dokku/blob/master/LICENSE) © Jeff Lindsay
|