mirror of
https://github.com/dokku/dokku.git
synced 2026-02-24 04:00:36 +01:00
4a1a2a326a
Several of the packages being installed were actually transitional packages, that is, the package itself is either a complete no-op (since the package is already installed), or else the package only exists to depend on another package of a new name (to support people who are running older operating systems). For the former, we can drop the dependency entirely, and for the latter we should use the new package name directly.
41 lines
2.4 KiB
Markdown
41 lines
2.4 KiB
Markdown
# Debian Package Installation Notes
|
|
|
|
As of 0.3.18, Dokku defaults to being installed via Debian package. While certain hosts may require extra work to get running, you may optionally wish to automate the installation of Dokku without the use of our `bootstrap.sh` Bash script. The following are the steps run by said script:
|
|
|
|
```shell
|
|
# install docker
|
|
wget -nv -O - https://get.docker.com/ | sh
|
|
|
|
# install dokku
|
|
wget -qO- https://packagecloud.io/dokku/dokku/gpgkey | sudo tee /etc/apt/trusted.gpg.d/dokku.asc
|
|
# programmatically determine distro and codename
|
|
DISTRO="$(awk -F= '$1=="ID" { print tolower($2) ;}' /etc/os-release)"
|
|
OS_ID="$(awk -F= '$1=="VERSION_CODENAME" { print tolower($2) ;}' /etc/os-release)"
|
|
echo "deb https://packagecloud.io/dokku/dokku/${DISTRO}/ ${OS_ID} main" | sudo tee /etc/apt/sources.list.d/dokku.list
|
|
sudo apt-get update -qq >/dev/null
|
|
sudo apt-get -qq -y install dokku
|
|
sudo dokku plugin:install-dependencies --core
|
|
```
|
|
|
|
## Unattended installation
|
|
|
|
In case you want to perform an unattended installation of Dokku, this is made possible through [debconf](https://en.wikipedia.org/wiki/Debconf_%28software_package%29), which allows you to configure a package before installing it.
|
|
|
|
You can set any of the below options through the `debconf-set-selections` command, for example to enable vhost-based deployments:
|
|
|
|
```bash
|
|
echo "dokku dokku/vhost_enable boolean true" | sudo debconf-set-selections
|
|
```
|
|
|
|
After setting the desired options, proceed with the installation as described above.
|
|
|
|
### debconf options
|
|
|
|
| Name | Type | Default | Description |
|
|
| ------------------ | ------- | --------------------- | ------------------------------------------------------------------------ |
|
|
| dokku/vhost_enable | boolean | false | Use vhost-based deployments (e.g. `[yourapp].dokku.me`) |
|
|
| dokku/hostname | string | dokku.me | Hostname, used as vhost domain and for showing app URL after deploy |
|
|
| dokku/skip_key_file| boolean | false | Don't check for the existence of the dokku/key_file. Warning: Setting this to true, will require you to manually add an SSH key later on. |
|
|
| dokku/key_file | string | /root/.ssh/id_rsa.pub | Path on disk to an SSH key to add to the Dokku user (Will be ignored on `dpkg-reconfigure`) |
|
|
| dokku/nginx_enable | boolean | true | Enable nginx-vhosts plugin |
|