github/dokku
0
0
Fork 0
Code Issues Pull Requests Actions 5 Packages Projects Releases Wiki Activity

Merge pull request #5740 from dokku/5739-docs

Browse Source 
Add a note about how running plugin:install does not apply for docker-based installs
This commit is contained in:
josegonzalez
2023-03-14 07:38:50 -04:00
committed by GitHub
parent 11ab7e4442 9f410a1a5a
commit be8bb4fcfd
2 changed files with 14 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
docs/advanced-usage/plugin-management.md
View File

@@ -78,6 +78,8 @@ dokku plugin:installed postgres
### Installing a plugin ### Installing a plugin
> Note: Plugins installed in this method within a [docker-based installation](/docs/getting-started/install/docker.md) of Dokku do not persist across installs. Please see the [plugin installation section](/docs/getting-started/install/docker.md#plugin-installation) of the docker-based installation docs for further details.
Installing a plugin is easy as well using the `plugin:install` command. This command will also trigger the `install` pluginhook on all existing plugins. Installing a plugin is easy as well using the `plugin:install` command. This command will also trigger the `install` pluginhook on all existing plugins.
The most common usage is to install a plugin from a url. This url may be any of the following: The most common usage is to install a plugin from a url. This url may be any of the following:

12
docs/getting-started/install/docker.md
View File

@@ -40,6 +40,8 @@ Other docker container options can also be used when running Dokku, though the s
## Plugin Installation ## Plugin Installation
### On Dokku start
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: 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:
```yaml ```yaml
@@ -53,6 +55,16 @@ postgres: https://github.com/dokku/dokku-postgres.git
redis: https://github.com/dokku/dokku-redis.git redis: https://github.com/dokku/dokku-redis.git
``` ```
### Prior to Dokku start
The alternative is to build a custom docker image via a custom Dockerfile. This Dockerfile can run any `plugin:install` command. Note that the version installed at that time will be the one that persists. Below is an example Dockerfile showing this method.
```Dockerfile
FROM dokku/dokku:0.30.1
RUN dokku plugin:install https://github.com/dokku/dokku-postgres.git postgres
RUN dokku plugin:install https://github.com/dokku/dokku-redis.git redis
```
## SSH Key Management ## SSH Key Management
To initialize ssh-keys within the container, use `docker exec` to enter the container and run the appropriate ssh-keys commands. To initialize ssh-keys within the container, use `docker exec` to enter the container and run the appropriate ssh-keys commands.