fcb25e1842
While we will still build for 18.04, we will now stop testing against it. Instead, we will test against 20.04, the next EOL release after 18.04. Once Ubuntu 18.04 is EOL, any references to it will also be removed. Note that 18.04 support was already deprecated in Dokku 0.28.0, so this change is just acknowledging that deprecation.
118 lines
10 KiB
Markdown
118 lines
10 KiB
Markdown
# Dokku
|
|
|
|
[](https://github.com/dokku/dokku/actions?query=workflow%3ACI)
|
|
[](https://packagecloud.io/dokku/dokku)
|
|
[](https://aur.archlinux.org/packages/dokku/)
|
|
[](https://slack.dokku.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)]
|
|
|
|
[](https://opencollective.com/dokku/sponsor/0/website)
|
|
[](https://opencollective.com/dokku/sponsor/1/website)
|
|
[](https://opencollective.com/dokku/sponsor/2/website)
|
|
[](https://opencollective.com/dokku/sponsor/3/website)
|
|
[](https://opencollective.com/dokku/sponsor/4/website)
|
|
[](https://opencollective.com/dokku/sponsor/5/website)
|
|
[](https://opencollective.com/dokku/sponsor/6/website)
|
|
[](https://opencollective.com/dokku/sponsor/7/website)
|
|
[](https://opencollective.com/dokku/sponsor/8/website)
|
|
[](https://opencollective.com/dokku/sponsor/9/website)
|
|
[](https://opencollective.com/dokku/sponsor/10/website)
|
|
[](https://opencollective.com/dokku/sponsor/11/website)
|
|
[](https://opencollective.com/dokku/sponsor/12/website)
|
|
[](https://opencollective.com/dokku/sponsor/13/website)
|
|
[](https://opencollective.com/dokku/sponsor/14/website)
|
|
[](https://opencollective.com/dokku/sponsor/5/website)
|
|
[](https://opencollective.com/dokku/sponsor/16/website)
|
|
[](https://opencollective.com/dokku/sponsor/17/website)
|
|
[](https://opencollective.com/dokku/sponsor/18/website)
|
|
|
|
## Backers
|
|
|
|
Support us with a monthly donation and help us continue our activities. [[Become a backer](https://opencollective.com/dokku#backer)]
|
|
|
|
[](https://opencollective.com/dokku/backer/0/website)
|
|
[](https://opencollective.com/dokku/backer/1/website)
|
|
[](https://opencollective.com/dokku/backer/2/website)
|
|
[](https://opencollective.com/dokku/backer/3/website)
|
|
[](https://opencollective.com/dokku/backer/4/website)
|
|
[](https://opencollective.com/dokku/backer/5/website)
|
|
[](https://opencollective.com/dokku/backer/6/website)
|
|
[](https://opencollective.com/dokku/backer/7/website)
|
|
[](https://opencollective.com/dokku/backer/8/website)
|
|
[](https://opencollective.com/dokku/backer/9/website)
|
|
[](https://opencollective.com/dokku/backer/10/website)
|
|
[](https://opencollective.com/dokku/backer/11/website)
|
|
[](https://opencollective.com/dokku/backer/12/website)
|
|
[](https://opencollective.com/dokku/backer/13/website)
|
|
[](https://opencollective.com/dokku/backer/14/website)
|
|
[](https://opencollective.com/dokku/backer/15/website)
|
|
[](https://opencollective.com/dokku/backer/16/website)
|
|
[](https://opencollective.com/dokku/backer/17/website)
|
|
[](https://opencollective.com/dokku/backer/18/website)
|
|
[](https://opencollective.com/dokku/backer/19/website)
|
|
[](https://opencollective.com/dokku/backer/20/website)
|
|
[](https://opencollective.com/dokku/backer/21/website)
|
|
[](https://opencollective.com/dokku/backer/22/website)
|
|
[](https://opencollective.com/dokku/backer/23/website)
|
|
[](https://opencollective.com/dokku/backer/24/website)
|
|
[](https://opencollective.com/dokku/backer/25/website)
|
|
[](https://opencollective.com/dokku/backer/26/website)
|
|
[](https://opencollective.com/dokku/backer/27/website)
|
|
[](https://opencollective.com/dokku/backer/28/website)
|
|
[](https://opencollective.com/dokku/backer/29/website)
|
|
|
|
## Requirements
|
|
|
|
A fresh VM running any of the following operating systems:
|
|
|
|
- Ubuntu 20.04 / 22.04 x64 - Any currently supported release
|
|
- Debian 10+ x64
|
|
- 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://dokku.com/install/v0.29.4/bootstrap.sh
|
|
sudo DOKKU_TAG=v0.29.4 bash bootstrap.sh
|
|
```
|
|
|
|
You can then proceed to configure your server domain (via `dokku domains:set-global`) and user access (via `dokku ssh-keys:add`) to complete the 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/>.
|
|
|
|
## 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://slack.dokku.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://slack.dokku.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
|