177f0be21c
# History ## 0.25.5 Install/update via the bootstrap script: ```shell wget https://raw.githubusercontent.com/dokku/dokku/v0.25.5/bootstrap.sh sudo DOKKU_TAG=v0.25.5 bash bootstrap.sh ``` ### Bug Fixes - #4787: @josegonzalez Do not require double quotes when issuing dokku run commands - #4816: @josegonzalez Set the DOKKU_HOST_ROOT on docker container start - #4810: @josegonzalez Handle udp ports when fetching network config - #4812: @josegonzalez Silence stderr when fetching a command from the Procfile - #4800: @josegonzalez Add help2man os package for copyfiles make target to devcontainer - #4796: @josegonzalez Remove the --restart flag from pre-deploy chown containers ### New Features - #4809: @josegonzalez Implement storage:ensure-directory command - #4801: @josegonzalez Expose git-from-archive and git-from-image plugin triggers - #4785: @josegonzalez Add support for VSCode Dev Containers ### Documentation - #4819: @stephenheron Fixed typo in tar documentation - #4824: @dy3l Fix GitLab case - #4822: @josegonzalez Add a note about using the registry:login command for private image deployments - #4808: @francipvb Added a comment about Dockerfile deployment - #4807: @FinnWoelm Docs: Fix instructions for enabling Docker Buildkit - #4786: @josegonzalez Add missing argument from trigger documentation - #4780: @adam12 Update source for `dokku-update` ### Tests - #4828: @josegonzalez Update golang in test apps to latest version - #4815: @josegonzalez tests: use python3 shebang for shellcheck-to-junit script - #4814: @josegonzalez Add wget to devcontainer to fix shfmt installation - #4791: @josegonzalez Fix test running in devcontainer ### Other - #4813: @dependabot[bot] chore(deps-dev): bump heroku/heroku-buildpack-php from 197 to 198 in /tests/apps/php - #4802: @dependabot[bot] chore(deps): bump django from 3.1.12 to 3.1.13 in /tests/apps/dockerfile-release - #4784: @josegonzalez Upgrade vector image to 0.16.x
2.7 KiB
Docker Installation Notes
Pull the dokku/dokku image:
docker pull dokku/dokku:0.25.5
Next, run the image.
docker container run \
--env DOKKU_HOSTNAME=dokku.me \
--env DOKKU_HOST_ROOT=/var/lib/dokku/home/dokku \
--name dokku \
--publish 3022:22 \
--publish 8080:80 \
--publish 8443:443 \
--volume /var/lib/dokku:/mnt/dokku \
--volume /var/run/docker.sock:/var/run/docker.sock \
dokku/dokku:0.25.5
Dokku is run in the following configuration:
- The global hostname is set to
dokku.meon boot. - The container name is dokku.
- Container SSH port 22 is exposed on the host as 3022.
- Container HTTP port 80 is exposed on the host as 8080.
- Container HTTPS port 443 is exposed on the host as 8443.
- Data within the container is stored on the host within the
/var/lib/dokkudirectory. - Image build cache is set to the data dir +
/home/dokku. - The docker socket is mounted into container.
Application repositories, plugin config, as well as plugin data are persisted to disk within the specified host directory for /var/lib/dokku.
Other docker container options can also be used when running Dokku, though the specific outcome will depend upon the specified options. For example, the Dokku container's nginx port can be bound to a specific host ip by specifying --publish $HOST_IP:8080:80, where $HOST_IP is the IP desired. Please see the docker container run documentation for further explanation for various docker arguments.
Plugin Installation
To install custom plugins, create a plugin-list file in the host's /var/lib/dokku directory. The plugins listed herein will be automatically installed by Dokku on container boot. This file should be the following format:
plugin_name: repository_url
An example for installing the postgres and redis plugins follows:
postgres: https://github.com/dokku/dokku-postgres.git
redis: https://github.com/dokku/dokku-redis.git
SSH Key Management
To initialize ssh-keys within the container, use docker exec to enter the container and run the appropriate ssh-keys commands.
docker exec -it dokku bash
Please see the user management documentation for more information.
Pushing Applications
When exposing the Dokku container's SSH port (22) on 3022, something similar to the following will need to be setup within the user's ~/.ssh/config:
Host dokku.docker
HostName 127.0.0.1
Port 3022
In the above example, the hostname 127.0.0.1 is being aliased to dokku.docker, while the port is being overriden to 3022. All SSH commands - including git pushes - for the hostname dokku.docker will be transparently sent to 127.0.0.1:3022.