afaff73025
# History ## 0.29.0 Install/update via the bootstrap script: ```shell wget https://raw.githubusercontent.com/dokku/dokku/v0.29.0/bootstrap.sh sudo DOKKU_TAG=v0.29.0 bash bootstrap.sh ``` See the [0.29.0 migration guide](/docs/appendices/0.29.0-migration-guide.md) for more information on migrating to 0.29.0. ### Bug Fixes - #5506: @josegonzalez Add support for escaped plus (+) signs in vector configurations - #5505: @josegonzalez Add missing event hooks - #5493: @josegonzalez Correct issue with detection of non-https port mapping as https port mapping - #5499: @josegonzalez Do not use traefik priority in service name - #5491: @josegonzalez Add missing http part to traefik routing rule - #5477: @josegonzalez Add missing config_sub entry to config gitignore - #5474: @josegonzalez Add missing source call - #5345: @esirK Always set app created-at via property instead of introspecting on folder creation time - #5456: @cooperaj Ensure Traefik only attempts to obtain certificate for api when enabled - #5466: @josegonzalez Drop the app argument when calling storage:ensure-directory from remote client - #5458: @cooperaj Ensure the TLS resolver is specifed for HTTPS enabled apps - #5448: @josegonzalez Do not attempt to attach a network to a container that already has it ### New Features - #5494: @josegonzalez Silence the warning message when there are no dokku apps on install - #5490: @josegonzalez Add ability to set a custom priority for traefik routing rules - #5489: @josegonzalez Use exit code 137 to signify a lock was unable to be retrieved when calling ps:retire - #5487: @josegonzalez Use a priority when routing requests with traefik - #5481: @josegonzalez Drop installation of nginx ppa - #5478: @josegonzalez Allow users to enable herokuish usage on arm/arm64 platforms - #5479: @josegonzalez Cleanup builder code and docs - #5476: @josegonzalez Add fileutils plugin to the devcontainer - #5473: @josegonzalez Add warning when a user is attempting to deploy with an ipv4/ipv6 domain name and has the default nginx site file available - #5451: @josegonzalez Add git:status subcommand - #5349: @josegonzalez Error out when executing caddy and traefik commands without the compose plugin installed - #5322: @josegonzalez Implement run:logs command - #5321: @josegonzalez Implement run:stop command - #5434: @josegonzalez Upgrade to go 1.19 everywhere - #5320: @josegonzalez Add json format output to run:list ### Refactors - #5488: @josegonzalez De-duplicate proxy building and simplify url generation - #5454: @josegonzalez Switch from base64-encoding to base36-encoding of cron task IDs ### Documentation - #5509: @josegonzalez Update data loss blockquote to be warning - #5507: @josegonzalez Add tutorials link to navigation - #5503: @josegonzalez Document potential deployment downtime - #5484: @IgnisDa Add edgedb community plugin - #5482: @JonathanMH Fixes minor typos in proxy docs - #5465: @josegonzalez Fix embedded lists on deployment tasks - #5430: @pablobm Clarify that proxy:build-config is required for any nginx:set call - #5447: @josegonzalez Specify correct command for builder-lambda:report - #5429: @pablobm Clarify details of the default template ### Tests - #5449: @josegonzalez Install goverage via go get ### Other - #5500: @dependabot[bot] chore(deps): bump maven-dependency-plugin from 3.3.0 to 3.4.0 in /tests/apps/java - #5472: @josegonzalez Start started proxies automatically during ps:restore - #5497: @dependabot[bot] chore(deps): bump ruby from 3.1.2 to 3.1.3 in /tests/apps/dockerfile-entrypoint - #5496: @dependabot[bot] chore(deps): bump sinatra from 3.0.3 to 3.0.4 in /tests/apps/ruby - #5480: @josegonzalez Cleanup zero'd out processes when a Procfile omitting those process types is set - #5475: @josegonzalez Refactor nginx.conf.sigil to be extracted from a specified path in source code instead of the built image - #5467: @josegonzalez Move DOKKU_WAIT_TO_RETIRE to a checks property - #5455: @dependabot[bot] chore(deps): bump hadolint/hadolint-action from 2.1.0 to 3.0.0 - #5463: @dependabot[bot] chore(deps): bump sinatra from 3.0.2 to 3.0.3 in /tests/apps/ruby - #5450: @dependabot[bot] chore(deps-dev): bump heroku/heroku-buildpack-php from 226 to 227 in /tests/apps/php - #5437: @dependabot[bot] chore(deps): bump golang from 1.19.2 to 1.19.3 in /tests/apps/zombies-dockerfile-tini - #5441: @dependabot[bot] chore(deps): bump golang from 1.19.2 to 1.19.3 in /tests/apps/gogrpc - #5440: @dependabot[bot] chore(deps): bump golang from 1.19.2 to 1.19.3 in /tests/apps/go-fail-predeploy - #5439: @dependabot[bot] chore(deps): bump golang from 1.19.2 to 1.19.3 in /tests/apps/zombies-dockerfile-no-tini - #5438: @dependabot[bot] chore(deps): bump golang from 1.19.2 to 1.19.3 in /tests/apps/go-fail-postdeploy - #5431: @dependabot[bot] chore(deps-dev): bump heroku/heroku-buildpack-php from 225 to 226 in /tests/apps/php - #5426: @dependabot[bot] chore(deps): bump python from 3.10.0-buster to 3.11.0-buster in /tests/apps/dockerfile-release - #5319: @josegonzalez Use container name instead of container id for run:detached output - #5427: @dependabot[bot] chore(deps): bump python from 3.10.8-alpine to 3.11.0-alpine in /docs/_build
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 18.04 / 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://raw.githubusercontent.com/dokku/dokku/v0.29.0/bootstrap.sh
|
|
sudo DOKKU_TAG=v0.29.0 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
|