Release 0.31.2

# History ## 0.31.2 Install/update via the bootstrap script: ```shell wget -NP . https://dokku.com/install/v0.31.2/bootstrap.sh sudo DOKKU_TAG=v0.31.2 bash bootstrap.sh ``` ### Bug Fixes - #6154: @josegonzalez Ensure app clones have domains setup - #6164: @josegonzalez Use correct path for openresty letsencrypt data - #6165: @josegonzalez Ensure we cleanup extracted files prior to next deployment - #6166: @josegonzalez Remove unused source from openresty trigger - #6163: @josegonzalez Add missing triggers for openresty-vhosts plugin - #6151: @josegonzalez Do not pass an empty argument to scheduler-run when triggering cron tasks manually - #6150: @josegonzalez Correct issue where temp file cleanup fails deploy ### Documentation - #6167: @josegonzalez Correct svg path on homepage - #6153: @imankulov Fix superscript typos in plugin documentation ### Tests - #6152: @josegonzalez Use buildjet for building arm images - #6149: @josegonzalez Fix issue where CI cannot install docker-compose-plugin ### Dependencies - #6161: @josegonzalez Upgrade sigil to 0.10.1 - #6162: @josegonzalez Upgrade herokuish to 0.7.1 - #6160: @josegonzalez Upgrade sshcommand to 0.17.1 - #6159: @josegonzalez Upgrade procfile-util to 0.16.0 - #6158: @josegonzalez Upgrade netrc to 0.7.1 - #6157: @josegonzalez Upgrade lambda-builder to 0.5.0 - #6147: @dependabot[bot] chore(deps): bump tj-actions/changed-files from 37.6.1 to 38.1.0 - #6145: @dependabot[bot] chore(deps): bump mkdocs-material from 9.2.2 to 9.2.3 in /docs/_build - #6139: @dependabot[bot] chore(deps): bump flask from 2.3.2 to 2.3.3 in /tests/apps/multi - #6140: @dependabot[bot] chore(deps): bump flask from 2.3.2 to 2.3.3 in /tests/apps/python-flask - #6141: @dependabot[bot] chore(deps): bump mkdocs-material from 9.1.21 to 9.2.2 in /docs/_build ### Other - #6148: @josegonzalez Add missing relabel command to docker-image-labeler for CNB builder
Merge pull request #6154 from dokku/6146-ensure-domains-on-clone
2023-08-28 04:08:55 +00:00 · 2023-08-27 23:41:49 -04:00 · 2023-08-27 23:00:18 -04:00 · 2023-08-27 21:29:12 -04:00 · 2023-08-27 21:07:48 -04:00 · 2023-08-27 20:00:45 -04:00
181 changed files with 1445 additions and 643 deletions
--- a/.github/actions/build-image/action.yml
+++ b/.github/actions/build-image/action.yml
@@ -0,0 +1,39 @@
+---
+name: 'build-image'
+
+description: 'builds a dokku docker image'
+
+inputs:
+  architecture:
+    description: 'platform to build'
+    required: true
+    default: 'linux/amd64'
+
+runs:
+  using: "composite"
+  steps:
+    - name: download packages
+      uses: actions/download-artifact@v3
+      with:
+        name: build
+        path: build
+
+    - name: set up docker buildx
+      id: buildx
+      uses: docker/setup-buildx-action@v2
+
+    - name: build docker image
+      shell: bash
+      run: |
+        if [[ "${{ inputs.architecture }}" == "linux/arm" ]]; then
+          docker buildx build \
+                --platform linux/arm \
+                --progress plain \
+                --tag "dokku/dokku:latest" \
+                .
+        else
+          docker buildx build \
+                  --progress plain \
+                  --tag "dokku/dokku:latest" \
+                  .
+        fi
--- a/.github/linters/.markdown-lint.yml
+++ b/.github/linters/.markdown-lint.yml
@@ -8,3 +8,30 @@ MD013: false
 # Inline HTML
 # https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md033
 MD033: false
+
+# List indentation
+# 2 spaces breaks list formatting in mkdocs
+# https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md007
+MD007:
+  indent: 4
+
+# Fenced code blocks should have a language specified
+# We use a second, un-languaged code block to denote the output
+# https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md040
+MD040: false
+
+# Blank line inside blockquote
+# This is typically done when a section has a "New as of" or "Warning" in addition to a note
+# May wish to take advantage of github-style admonitions
+# https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md028
+MD028: false
+
+# No duplicate headers
+# HISTORY.md has a ton of these
+# https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md024
+MD024: false
+
+# First line h1
+# The issue template doesn't have one
+# https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md041
+MD041: false
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -14,6 +14,9 @@ concurrency:
  group: build-${{ github.event.pull_request.number || github.ref }}
  cancel-in-progress: true

+env:
+  INSTALL_DOCKER_REPO: 1
+
 jobs:
  check-commit:
    runs-on: ubuntu-20.04
@@ -77,42 +80,50 @@ jobs:
          name: build
          path: build

-  build-image:
-    name: build-image.${{ matrix.architecture }}
+  build-image-amd64:
+    name: build-image.linux/amd64
    needs: build
    runs-on: ubuntu-20.04
-    strategy:
-      fail-fast: false
-      matrix:
-        architecture:
-          - linux/amd64
-          - linux/arm
-          - linux/arm64
+    timeout-minutes: 20

    steps:
      - uses: actions/checkout@v3

-      - name: download packages
-        uses: actions/download-artifact@v3
+      - name: build-image
+        uses: ./.github/actions/build-image
        with:
-          name: build
-          path: build
+          architecture: linux/amd64
+
+  build-image-arm:
+    name: build-image.linux/arm
+    needs: build
+    runs-on: buildjet-4vcpu-ubuntu-2204-arm
+    timeout-minutes: 20
+
+    steps:
+      - uses: actions/checkout@v3

      - name: set up qemu
        uses: docker/setup-qemu-action@v2

-      - name: set up docker buildx
-        id: buildx
-        uses: docker/setup-buildx-action@v2
+      - name: build-image
+        uses: ./.github/actions/build-image
+        with:
+          architecture: linux/arm

-      - name: build docker image
-        timeout-minutes: 20
-        run: |
-          docker buildx build \
-                --platform ${{ matrix.architecture }} \
-                --progress plain \
-                --tag "dokku/dokku:latest" \
-                .
+  build-image-arm64:
+    name: build-image.linux/arm64
+    needs: build
+    runs-on: buildjet-4vcpu-ubuntu-2204-arm
+    timeout-minutes: 20
+
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: build-image
+        uses: ./.github/actions/build-image
+        with:
+          architecture: linux/arm64

  unit-tests:
    name: unit.${{ matrix.index }}
@@ -138,7 +149,7 @@ jobs:
      #   uses: luchihoratiu/debug-via-ssh@main
      #   with:
      #     NGROK_AUTH_TOKEN: ${{ secrets.NGROK_AUTH_TOKEN }}
-      #     SSH_PASS: ${{ secrets.SSH_PASS }}
+      #     SSH_PASS: ${{ secrets.NGROK_SSH_PASS }}

      - name: run ci
        timeout-minutes: 30
--- a/.github/workflows/lint.yml
+++ b/.github/workflows/lint.yml
@@ -27,12 +27,16 @@ jobs:
    steps:
      - name: Clone
        uses: actions/checkout@v3
-      - name: Run markdown-lint
-        uses: avto-dev/markdown-lint@04d43ee9191307b50935a753da3b775ab695eceb
-        # v1.5.0 => 04d43ee9191307b50935a753da3b775ab695eceb
+      - name: Setup node
+        uses: actions/setup-node@v3
        with:
-          config: '.github/linters/.markdown-lint.yml'
-          args: './README.md'
+          node-version: '20'
+          cache: 'npm'
+          cache-dependency-path: '.github/workflows/lint.yml'
+      - name: Install markdownlint-cli
+        run: npm install -g markdownlint-cli@0.35.0
+      - name: Run markdown-lint
+        run: markdownlint -c .github/linters/.markdown-lint.yml *.md **/*.md

  packer:
    name: packer
@@ -50,7 +54,7 @@ jobs:
          PACKER_GITHUB_API_TOKEN: ${{ secrets.GITHUB_TOKEN }}
      - name: Get changed files in the docs folder
        id: changed-files-specific
-        uses: tj-actions/changed-files@v37.5.2
+        uses: tj-actions/changed-files@v38.1.0
        with:
          files: contrib/images/digitalocean/**
      - name: Run `packer validate`
--- a/.gitignore
+++ b/.gitignore
@@ -11,3 +11,4 @@ test-results/
 stack.tgz
 tmp
 coverage.out
+site
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -19,11 +19,11 @@ a chance of keeping on top of things.
 - [Reporting Security Issues](#reporting-security-issues)
 - [Reporting Issues](#reporting-other-issues)
 - [Contributing](#contributing)
-  - [Making Changes](#making-changes)
-  - [Which branch to base the work](#which-branch-to-base-the-work)
-  - [Submitting Changes](#submitting-changes)
-  - [When will my change be merged?](#when-will-my-change-be-merged)
-  - [Running tests locally](#running-tests-locally)
+    - [Making Changes](#making-changes)
+    - [Which branch to base the work](#which-branch-to-base-the-work)
+    - [Submitting Changes](#submitting-changes)
+    - [When will my change be merged?](#when-will-my-change-be-merged)
+    - [Running tests locally](#running-tests-locally)
 - [Additional Resources](#additional-resources)

 ## Reporting security issues
@@ -65,24 +65,24 @@ need to do

 - Make sure you have a [GitHub account](https://github.com/signup/free).
 - Submit an [issue](https://github.com/dokku/dokku/issues), assuming one does not already exist.
-  - Clearly describe the issue including steps to reproduce when it is a bug.
-  - Make sure you fill in the earliest version that you know has the issue.
+    - Clearly describe the issue including steps to reproduce when it is a bug.
+    - Make sure you fill in the earliest version that you know has the issue.
 - Fork the repository on GitHub.

 ### Making Changes

 - Create a topic branch from where you want to base your work.
-  - This is usually the master branch.
-  - Only target an existing branch if you are certain your fix must be on that
-    branch.
-  - To quickly create a topic branch based on master; `git checkout -b my_contribution origin/master`.
-    It is best to avoid working directly on the `master` branch. Doing so will
+    - This is usually the master branch.
+    - Only target an existing branch if you are certain your fix must be on that
+      branch.
+    - To quickly create a topic branch based on master; `git checkout -b my_contribution origin/master`.
+      It is best to avoid working directly on the `master` branch. Doing so will
    help avoid conflicts if you pull in updates from origin.
 - Make commits of logical units. Implementing a new function and calling it in
  another file constitute a single logical unit of work.
-  - Before you make a pull request, squash your commits into logical units of work
-    using `git rebase -i` and `git push -f`.
-  - A majority of submissions should have a single commit, so if in doubt,
+    - Before you make a pull request, squash your commits into logical units of work
+      using `git rebase -i` and `git push -f`.
+    - A majority of submissions should have a single commit, so if in doubt,
    squash your commits down to one commit.
 - Check for unnecessary whitespace with `git diff --check` before committing.
 - Use descriptive commit messages and reference the #issue number.
@@ -92,7 +92,7 @@ need to do
 - Your work should apply the [Dokku coding standards](https://github.com/progrium/bashstyle)
 - Pull requests must be cleanly rebased on top of master without multiple branches
  mixed into the PR.
-  - **Git tip**: If your PR no longer merges cleanly, use `rebase master` in your
+    - **Git tip**: If your PR no longer merges cleanly, use `rebase master` in your
    feature branch to update your pull request rather than `merge master`.

 ### Which branch to base the work
--- a/HISTORY.md
+++ b/HISTORY.md
@@ -1,5 +1,91 @@
 # History

+## 0.31.2
+
+Install/update via the bootstrap script:
+
+```shell
+wget -NP . https://dokku.com/install/v0.31.2/bootstrap.sh
+sudo DOKKU_TAG=v0.31.2 bash bootstrap.sh
+```
+
+### Bug Fixes
+
+- #6154: @josegonzalez Ensure app clones have domains setup
+- #6164: @josegonzalez Use correct path for openresty letsencrypt data
+- #6165: @josegonzalez Ensure we cleanup extracted files prior to next deployment
+- #6166: @josegonzalez Remove unused source from openresty trigger
+- #6163: @josegonzalez Add missing triggers for openresty-vhosts plugin
+- #6151: @josegonzalez Do not pass an empty argument to scheduler-run when triggering cron tasks manually
+- #6150: @josegonzalez Correct issue where temp file cleanup fails deploy
+
+### Documentation
+
+- #6167: @josegonzalez Correct svg path on homepage
+- #6153: @imankulov Fix superscript typos in plugin documentation
+
+### Tests
+
+- #6152: @josegonzalez Use buildjet for building arm images
+- #6149: @josegonzalez Fix issue where CI cannot install docker-compose-plugin
+
+### Dependencies
+
+- #6161: @josegonzalez Upgrade sigil to 0.10.1
+- #6162: @josegonzalez Upgrade herokuish to 0.7.1
+- #6160: @josegonzalez Upgrade sshcommand to 0.17.1
+- #6159: @josegonzalez Upgrade procfile-util to 0.16.0
+- #6158: @josegonzalez Upgrade netrc to 0.7.1
+- #6157: @josegonzalez Upgrade lambda-builder to 0.5.0
+- #6147: @dependabot[bot] chore(deps): bump tj-actions/changed-files from 37.6.1 to 38.1.0
+- #6145: @dependabot[bot] chore(deps): bump mkdocs-material from 9.2.2 to 9.2.3 in /docs/_build
+- #6139: @dependabot[bot] chore(deps): bump flask from 2.3.2 to 2.3.3 in /tests/apps/multi
+- #6140: @dependabot[bot] chore(deps): bump flask from 2.3.2 to 2.3.3 in /tests/apps/python-flask
+- #6141: @dependabot[bot] chore(deps): bump mkdocs-material from 9.1.21 to 9.2.2 in /docs/_build
+
+### Other
+
+- #6148: @josegonzalez Add missing relabel command to docker-image-labeler for CNB builder
+
+## 0.31.1
+
+Install/update via the bootstrap script:
+
+```shell
+wget -NP . https://dokku.com/install/v0.31.1/bootstrap.sh
+sudo DOKKU_TAG=v0.31.1 bash bootstrap.sh
+```
+
+### Bug Fixes
+
+- #6133: @josegonzalez Properly handle tag and branch pushes
+- #6131: @josegonzalez Ensure tmp files are cleaned up when commands exit
+- #6130: @josegonzalez Correct package for container healthchecker when building digitalocean image
+- #6121: @josegonzalez Add missing error-log-path function to openresty plugin
+
+### Documentation
+
+- #6129: @josegonzalez Cleanup markdown and use Github Admonitions
+
+### Dependencies
+
+- #6120: @dependabot[bot] chore(deps): bump click from 8.1.6 to 8.1.7 in /docs/_build
+- #6119: @dependabot[bot] chore(deps): bump tj-actions/changed-files from 37.6.0 to 37.6.1
+- #6118: @dependabot[bot] chore(deps): bump werkzeug from 2.3.6 to 2.3.7 in /tests/apps/python-flask
+- #6115: @dependabot[bot] chore(deps): bump golang from 1.20.7 to 1.21.0 in /tests/apps/zombies-dockerfile-no-tini
+- #6114: @dependabot[bot] chore(deps): bump golang from 1.20.7 to 1.21.0 in /tests/apps/zombies-dockerfile-tini
+- #6104: @dependabot[bot] chore(deps): bump golang.org/x/net from 0.13.0 to 0.14.0 in /tests/apps/gogrpc
+- #6113: @dependabot[bot] chore(deps): bump golang from 1.20.7 to 1.21.0 in /tests/apps/go-fail-predeploy
+- #6112: @dependabot[bot] chore(deps): bump golang from 1.20.7 to 1.21.0 in /tests/apps/go-fail-postdeploy
+- #6111: @dependabot[bot] chore(deps): bump golang from 1.20.7 to 1.21.0 in /tests/apps/gogrpc
+- #6107: @dependabot[bot] chore(deps): bump pygments from 2.15.1 to 2.16.1 in /docs/_build
+- #6106: @dependabot[bot] chore(deps): bump tj-actions/changed-files from 37.5.2 to 37.6.0
+- #6105: @dependabot[bot] chore(deps): bump sinatra from 3.0.6 to 3.1.0 in /tests/apps/ruby
+
+### Other
+
+- #6122: @josegonzalez Plugin trigger and event cleanup
+
 ## 0.31.0

 Install/update via the bootstrap script:
@@ -374,7 +460,7 @@ sudo DOKKU_TAG=v0.30.4 bash bootstrap.sh

 ### Bug Fixes

- #5786: @obrienmd Detect id_ed25519.pub in git:public-key command 
+- #5786: @obrienmd Detect id_ed25519.pub in git:public-key command
 - #5758: @josegonzalez Support pack-based images that do not have a Procfile

 ### New Features
@@ -999,7 +1085,7 @@ See the [0.28.0 migration guide](/docs/appendices/0.28.0-migration-guide.md) for

 ### New Features

- #5300: @josegonzalez Add the ability to disable the init process 
+- #5300: @josegonzalez Add the ability to disable the init process
 - #5295: @josegonzalez Add an official caddy proxy implementation
 - #5293: @josegonzalez Add an official traefik proxy implementation
 - #5202: @josegonzalez Add builder-lambda plugin
@@ -1063,7 +1149,7 @@ sudo DOKKU_TAG=v0.27.9 bash bootstrap.sh

 ### Other

- #5184: @yasoob New website. Closes #5175 
+- #5184: @yasoob New website. Closes #5175
 - #5270: @dependabot[bot] chore(deps): bump werkzeug from 2.2.0 to 2.2.1 in /tests/apps/python-flask
 - #5265: @dependabot[bot] chore(deps): bump werkzeug from 2.1.2 to 2.2.0 in /tests/apps/python-flask
 - #5264: @dependabot[bot] chore(deps): bump sinatra from 2.2.1 to 2.2.2 in /tests/apps/ruby
@@ -2736,7 +2822,7 @@ See the [0.22.0 migration guide](/docs/appendices/0.22.0-migration-guide.md) for

 - #4160: @nerg4l Rewrite logs plugin in Go
 - #4149: @josegonzalez Rewrite ps plugin in golang
- #4080: @hugopeixoto Stop using VHOST when listing app domains and urls 
+- #4080: @hugopeixoto Stop using VHOST when listing app domains and urls
 - #4117: @josegonzalez Rewrite app-json plugin in golang
 - #4113: @josegonzalez Drop herokuish release code

@@ -2869,7 +2955,8 @@ sudo DOKKU_TAG=v0.21.1 bash bootstrap.sh

 ## 0.21.0

-> Warning: Release is broken and will be pulled from upstream. Please use a newer version.
+> [!WARNING]
+> Release is broken and will be pulled from upstream. Please use a newer version.

 ### Bug Fixes

@@ -3379,7 +3466,7 @@ sudo DOKKU_TAG=v0.19.1 bash bootstrap.sh

 ### Bug Fixes

- #3713: @josegonzalez Require nginx 1.13+ in order to enable tls1.3 
+- #3713: @josegonzalez Require nginx 1.13+ in order to enable tls1.3

 ## 0.19.0

@@ -4745,7 +4832,7 @@ sudo DOKKU_TAG=v0.13.1 bash bootstrap.sh
 - #2683: @josegonzalez Ensure we have an example for adding keys as another user
 - #2682: @josegonzalez Clarify supported stanzas in app.json
 - #2679: @callahad Remove unnecessary Linode-specific instructions
- #2670: @znz Remove duplicated `(i.e. `
+- #2670: @znz Remove duplicated `(i.e.`

 ### Documentation

@@ -5099,7 +5186,7 @@ Thanks to all the contributors who helped with this release, and a special thank

 ## 0.5.8

-This release is the last release in the `0.5.x` series, and as such is mainly a bugfix release. Users are highly encouraged to upgrade to this release *before* moving to the upcoming `0.6.x` release, as we will be removing deprecated features at that point.
+This release is the last release in the `0.5.x` series, and as such is mainly a bugfix release. Users are highly encouraged to upgrade to this release _before_ moving to the upcoming `0.6.x` release, as we will be removing deprecated features at that point.

 Thanks to all the contributors who helped with this release!

@@ -5291,7 +5378,7 @@ That was quick! This is a bugfix release to fix issues in the packaging and rele

 This is our largest, most feature-packed release in the history of the dokku project. Lots of delicious things, including:

- Support for docker 1.10/1.11. You *must* have docker 1.9.1+ to install dokku.
+- Support for docker 1.10/1.11. You _must_ have docker 1.9.1+ to install dokku.
 - Revamped documentation website
 - [Deployment Tasks](https://dokku.com/docs/advanced-usage/deployment-tasks/)
 - Heroku-style management of [dockerfile processes](https://dokku.com/docs/deployment/builders/dockerfiles/#procfiles-and-multiple-processes)
@@ -5390,7 +5477,7 @@ Thanks to all the contributors who helped with this release!

 ## 0.4.13

-We lied. *This* is the final 0.4.x release. This specific release fixes support for bash `4.2`, which may be the only bash version available for certain testing environments.
+We lied. _This_ is the final 0.4.x release. This specific release fixes support for bash `4.2`, which may be the only bash version available for certain testing environments.

 Thanks to all the contributors who helped with this release!

@@ -5444,7 +5531,7 @@ Thanks to all the contributors who helped with this release!
 This release is mostly a bugfix release, though we have a few important changes:

 - `dokku plugin:update` can now be used to update a specific plugin. Previously, this could potentially result in an error a user would have to manually resolve.
- We have started labeling all dokku-managed containers. In a future minor release, triggering a `dokku cleanup` will remove *only* exited containers that are managed by dokku. This change allows users to start containers outside of dokku and be assured that dokku would not inadvertently remove them.
+- We have started labeling all dokku-managed containers. In a future minor release, triggering a `dokku cleanup` will remove _only_ exited containers that are managed by dokku. This change allows users to start containers outside of dokku and be assured that dokku would not inadvertently remove them.

 Thanks to all the contributors who helped with this release!

@@ -5790,11 +5877,11 @@ One new feature is colorized logging output, which should make it easier to debu
 This is our first minor release in almost a year. Many new features and removals have occurred, so here is a neat summary:

 - Plugins are now triggered via `plugn`. Notably, you'll need add a `plugin.toml` to describe the plugin as well as use `plugn trigger` instead of `pluginhook` to trigger plugin callbacks. Please see the [plugin creation documentation](https://dokku.com/docs/development/plugin-creation/) for more details.
- A few new official plugins have been added to the core, including [image tagging](https://dokku.com/docs/deployment/application-deployment/), [certificate management](https://dokku.com/docs/configuration/ssl/), a tar-based deploy solution, and much more. Check out the *New Features* section for more details.
+- A few new official plugins have been added to the core, including [image tagging](https://dokku.com/docs/deployment/application-deployment/), [certificate management](https://dokku.com/docs/configuration/ssl/), a tar-based deploy solution, and much more. Check out the _New Features_ section for more details.
 - We've removed a few deprecated plugin callbacks. Please see the [plugin triggers documentation](https://dokku.com/docs/development/plugin-triggers/) to see what is available.
 - [Official datastorage plugins](https://github.com/dokku) have been created for the most commonly used datastores. If you previously used/maintained a community contributed plugin, please check these out. We'll be adding more official plugins as time goes on.

-Thanks to the *many* contributors for making this release our best release so far, and special thanks to both @michaelshobbs and @Flink for pushing along the `0.4.0` release!
+Thanks to the _many_ contributors for making this release our best release so far, and special thanks to both @michaelshobbs and @Flink for pushing along the `0.4.0` release!

 ### Deprecations and Removals

@@ -6116,10 +6203,10 @@ This release pegs Dokku to Docker 1.6.2. Docker 1.7.0 introduced changes in `doc
 - #1028: @Flink [docs] Add rails-logs to plugins
 - #1031: @michaelshobbs Upgrade docker in CI to 1.5.0
 - #1029: @assaf Added several enhancements for CHECKS file:
-  - Specify how long to wait before running first check
-  - Specify timeout for each check
-  - Check specific hosts, e.g. http://signin.example.com
-  - Check both HTTP and HTTPS resources
+    - Specify how long to wait before running first check
+    - Specify timeout for each check
+    - Check specific hosts, e.g. [http://signin.example.com](http://signin.example.com)
+    - Check both HTTP and HTTPS resources
 - #1032: @cameron-martin Updated dokku-installer to use relative path
 - #1035: @Flink [docs] Add dokku-http-auth to plugins
 - #1040: @ebeigarts [docs] Add dokku-slack plugin information
@@ -6223,12 +6310,12 @@ This release pegs Dokku to Docker 1.6.2. Docker 1.7.0 introduced changes in `doc
 ## 0.3.9

 - #787: @josegonzalez/@michaelshobbs Official user-env-compile plugin
-  - Uses ENV and APP/ENV files
-  - Supports old `BUILD_ENV` files (which are likely in wide-use)
-  - Allows user's to override globals with app-specific configuration
-  - Migrate `$DOKKU_ROOT/BUILD_ENV` to `$DOKKU_ROOT/ENV` if the former exists and the latter does not
-  - Drop `BUILD_ENV` support in favor of just `ENV` via a `mv` command
-  - Add default ENV with `CURL_TIMEOUT` and `CURL_CONNECT_TIMEOUT`
+    - Uses ENV and APP/ENV files
+    - Supports old `BUILD_ENV` files (which are likely in wide-use)
+    - Allows user's to override globals with app-specific configuration
+    - Migrate `$DOKKU_ROOT/BUILD_ENV` to `$DOKKU_ROOT/ENV` if the former exists and the latter does not
+    - Drop `BUILD_ENV` support in favor of just `ENV` via a `mv` command
+    - Add default ENV with `CURL_TIMEOUT` and `CURL_CONNECT_TIMEOUT`
 - #811: @abossard Increased `server_names_hash_bucket_size` in nginx.conf to 512
 - #814: @josegonzalez Source files in $DOKKU_ROOT/.dokkurc directory and add `dokku trace` command
 - #816: @josegonzalez Add documentation for user-env feature
@@ -6337,25 +6424,25 @@ This release pegs Dokku to Docker 1.6.2. Docker 1.7.0 introduced changes in `doc

 ## 0.2.0 (2013-11-24)

-* Added DOKKU_TRACE variable for verbose trace information
-* Added an installer (for pre-built images)
-* Application config (environment variable management)
-* Backup/import plugin
-* Basic hooks/plugin system
-* Cache dir is preserved across builds
-* Command to delete an application
-* Exposed commands over SSH using sshcommand
-* Git handling is moved to a plugin
-* Integration test coverage
-* Pulled nginx vhosts out into plugin
-* Run command
-* Separated dokku and buildstep more cleanly
-* Uses latest version of Docker again
+- Added DOKKU_TRACE variable for verbose trace information
+- Added an installer (for pre-built images)
+- Application config (environment variable management)
+- Backup/import plugin
+- Basic hooks/plugin system
+- Cache dir is preserved across builds
+- Command to delete an application
+- Exposed commands over SSH using sshcommand
+- Git handling is moved to a plugin
+- Integration test coverage
+- Pulled nginx vhosts out into plugin
+- Run command
+- Separated dokku and buildstep more cleanly
+- Uses latest version of Docker again

 ## 0.1.0 (2013-06-15)

- * First release
-   * Bootstrap script for Ubuntu system
-   * Basic push / deploy with git
-   * Hostname support with Nginx
-   * Support for Java, Ruby, Node.js buildpacks
+- First release
+    - Bootstrap script for Ubuntu system
+    - Basic push / deploy with git
+    - Hostname support with Nginx
+    - Support for Java, Ruby, Node.js buildpacks
--- a/ISSUE_TEMPLATE.md
+++ b/ISSUE_TEMPLATE.md
@@ -39,10 +39,10 @@
 - The nginx configuration (if applicable) via `dokku nginx:show-config APP_NAME`
 - Link to the exact repository being deployed (if possible/applicable):
 - If a deploy is failing or behaving unexpectedly:
-  - Application name
-  - The type of application being deployed (node, php, python, ruby, etc.)
-  - If using buildpacks, which custom buildpacks are in use
-  - If using a `Dockerfile`, the contents of that file
-  - If it exists, the contents of your `Procfile`.
+    - Application name
+    - The type of application being deployed (node, php, python, ruby, etc.)
+    - If using buildpacks, which custom buildpacks are in use
+    - If using a `Dockerfile`, the contents of that file
+    - If it exists, the contents of your `Procfile`.
 - Output of failing Dokku commands after running `dokku trace:on`
  (BEWARE: `trace:on` will print environment variables for some commands, be sure you're not exposing any sensitive information when posting issues. You may replace these values with XXXXXX):
--- a/14
+++ b/14
@@ -2,15 +2,15 @@ DOKKU_VERSION ?= master

 TARGETARCH ?= amd64

-DOCKER_IMAGE_LABELER_VERSION ?= 0.5.0
+DOCKER_IMAGE_LABELER_VERSION ?= 0.6.1
 DOCKER_CONTAINER_HEALTHCHECKER_VERSION ?= 0.6.4
-HEROKUISH_VERSION ?= 0.6.0
-LAMBDA_BUILDER_VERSION ?= 0.4.0
-NETRC_VERSION ?= 0.6.0
+HEROKUISH_VERSION ?= 0.7.1
+LAMBDA_BUILDER_VERSION ?= 0.5.0
+NETRC_VERSION ?= 0.7.1
 PLUGN_VERSION ?= 0.12.0
-PROCFILE_VERSION ?= 0.15.0
-SIGIL_VERSION ?= 0.9.0
-SSHCOMMAND_VERSION ?= 0.16.0
+PROCFILE_VERSION ?= 0.16.0
+SIGIL_VERSION ?= 0.10.1
+SSHCOMMAND_VERSION ?= 0.17.1
 DOCKER_IMAGE_LABELER_URL ?= https://github.com/dokku/docker-image-labeler/releases/download/v${DOCKER_IMAGE_LABELER_VERSION}/docker-image-labeler_${DOCKER_IMAGE_LABELER_VERSION}_linux_${TARGETARCH}.tgz
 DOCKER_CONTAINER_HEALTHCHECKER_URL ?= https://github.com/dokku/docker-container-healthchecker/releases/download/v${DOCKER_CONTAINER_HEALTHCHECKER_VERSION}/docker-container-healthchecker_${DOCKER_CONTAINER_HEALTHCHECKER_VERSION}_linux_${TARGETARCH}.tgz
 LAMBDA_BUILDER_URL ?= https://github.com/dokku/lambda-builder/releases/download/v${LAMBDA_BUILDER_VERSION}/lambda-builder_${LAMBDA_BUILDER_VERSION}_linux_${TARGETARCH}.tgz
--- a/README.md
+++ b/README.md
@@ -86,8 +86,8 @@ Otherwise, you will need to import the keypair manually after installation using
 To install the latest stable release, run the following commands as a user who has access to `sudo`:

 ```shell
-wget -NP . https://dokku.com/install/v0.31.0/bootstrap.sh
-sudo DOKKU_TAG=v0.31.0 bash bootstrap.sh
+wget -NP . https://dokku.com/install/v0.31.2/bootstrap.sh
+sudo DOKKU_TAG=v0.31.2 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.
--- a/contrib/images/digitalocean/in_parts/012-dokku-packages
+++ b/contrib/images/digitalocean/in_parts/012-dokku-packages
@@ -33,7 +33,7 @@ pkgs=(apache2-utils
  debconf
 )

-dokku_pkgs=(docker-docker-container-healthchecker
+dokku_pkgs=(docker-container-healthchecker
  docker-image-labeler
  gliderlabs-sigil
  lambda-builder
--- a/contrib/write-mkdocs
+++ b/contrib/write-mkdocs
@@ -1,13 +1,19 @@
 #!/usr/bin/env python
-from bs4 import BeautifulSoup
 import os
 import pathlib
 import shutil
 import sys
+from collections.abc import Callable
+
 import yaml

+from bs4 import BeautifulSoup

-def get_nav_from_selector(soup, selector, docs_dir):
+
+def get_nav_from_selector(soup: BeautifulSoup, selector: str, docs_dir: str):
+    """
+    Generates navigation from template file
+    """
    navigation = []
    header_name = ""
    for anchor in soup.select(selector):
@@ -49,44 +55,50 @@ def get_nav_from_selector(soup, selector, docs_dir):
                    children = os.listdir(docs_dir + "/" + child_dir)
                    children = [child_dir + c for c in children]
                    children.sort()
-                    children.insert(
-                        0, "getting-started/advanced-installation.md")
+                    children.insert(0, "getting-started/advanced-installation.md")
                    if os.path.exists(docs_dir + "/" + filename):
                        children.insert(0, filename)
                    else:
-                        children.insert(
-                            0, "getting-started/installation/index.md")
-                    nav[header_name].append({
-                        "Getting Started with Dokku": children,
-                    })
+                        children.insert(0, "getting-started/installation/index.md")
+                    nav[header_name].append(
+                        {
+                            "Getting Started with Dokku": children,
+                        }
+                    )
                    continue
-                elif filename == "getting-started/upgrading.md":
+
+                if filename == "getting-started/upgrading.md":
                    child_dir = "appendices/"
                    children = os.listdir(docs_dir + "/" + child_dir)

-                    children.sort(key=lambda x: list(
-                        map(int, x.split("-")[0].split('.'))),
-                        reverse=True)
+                    children.sort(
+                        key=lambda x: list(map(int, x.split("-")[0].split("."))),
+                        reverse=True,
+                    )
                    children = [child_dir + c for c in children]
                    if os.path.exists(docs_dir + "/" + filename):
                        children.insert(0, filename)
                    else:
-                        children.insert(
-                            0, "getting-started/upgrading/index.md")
-                    nav[header_name].append({
-                        "Upgrading": children,
-                    })
+                        children.insert(0, "getting-started/upgrading/index.md")
+                    nav[header_name].append(
+                        {
+                            "Upgrading": children,
+                        }
+                    )
                    continue
-                else:
-                    nav[header_name].append(filename)
+
+                nav[header_name].append(filename)
    return navigation


-def generate_nav(src, dest):
+def generate_nav(src: str, dest: str) -> None:
+    """
+    Writes out navigation information to the mkdocs yaml file
+    """
    navigation = []
    repo_dir = pathlib.Path(__file__).parent.parent.resolve()
    docs_dir = str(repo_dir) + "/docs"
-    with open(docs_dir + "/template.html") as response:
+    with open(docs_dir + "/template.html", encoding="utf-8") as response:
        soup = BeautifulSoup(response, "html.parser")
        selectors = [
            ".container .row .list-group a",
@@ -101,21 +113,26 @@ def generate_nav(src, dest):
            print("No navigation found")
            sys.exit(1)

-    with open(src) as f:
-        data = yaml.unsafe_load(f)
+    with open(src, encoding="utf-8") as handler:
+        data = yaml.unsafe_load(handler)
        data["nav"] = [
            {"Docs": navigation},
            {"Pro": "https://pro.dokku.com/docs/getting-started/"},
            {"Blog": "https://dokku.com/blog/"},
            {"Tutorials": "https://dokku.com/tutorials/"},
-            {"Purchase Dokku Pro": "https://dokku.dpdcart.com/cart/add?product_id=217344&method_id=236878"},
+            {
+                "Purchase Dokku Pro": "https://dokku.dpdcart.com/cart/add?product_id=217344&method_id=236878"
+            },
        ]

-    with open(dest, mode="wt", encoding="utf-8") as f:
-        yaml.dump(data, f)
+    with open(dest, mode="wt", encoding="utf-8") as handler:
+        yaml.dump(data, handler)


-def modify_content_noop(lines, _):
+def modify_content_noop(lines: list[str], _) -> tuple[list[str], bool]:
+    """
+    Simply returns the lines as is
+    """
    modified = False
    updated_lines = []
    for line in lines:
@@ -123,11 +140,14 @@ def modify_content_noop(lines, _):
    return updated_lines, modified


-def modify_content_links(lines, filename):
+def modify_content_links(lines: list[str], filename: str) -> tuple[list[str], bool]:
+    """
+    Modifies links to be relative instead of absolute
+    """
    filename = filename.replace("/usr/src/source/docs/", "")
    parts = filename.split("/")
    parts.pop()
-    replacement = "](" + '/'.join([".." for _ in parts]) + "/"
+    replacement = "](" + "/".join([".." for _ in parts]) + "/"
    modified = False
    updated_lines = []
    for line in lines:
@@ -139,7 +159,10 @@ def modify_content_links(lines, filename):
    return updated_lines, modified


-def modify_content_stripspace(lines, _):
+def modify_content_stripspace(lines: list[str], _) -> tuple[list[str], bool]:
+    """
+    Removes trailing whitespace from each line
+    """
    modified = False
    updated_lines = []
    for line in lines:
@@ -148,7 +171,10 @@ def modify_content_stripspace(lines, _):
    return updated_lines, modified


-def modify_content_inject_newlines(lines, _):
+def modify_content_inject_newlines(lines: list[str], _) -> tuple[list[str], bool]:
+    """
+    Ensures every line has a trailing newline character
+    """
    modified = False
    updated_lines = []
    for line in lines:
@@ -156,47 +182,117 @@ def modify_content_inject_newlines(lines, _):
    return updated_lines, modified


-def is_info(line):
+def is_github_new(line: str, next_line: str | None) -> bool:
+    """
+    Checks if a given line is a github "new as of" admonition
+    """
+    if not next_line:
+        return False
+
+    return line.startswith("> [!IMPORTANT]") and "new as of" in next_line.lower()
+
+
+def is_github_note(line: str) -> bool:
+    """
+    Checks if a given line is a github "note" admonition
+    """
+    return line.startswith("> [!NOTE]")
+
+
+def is_github_warning(line: str) -> bool:
+    """
+    Checks if a given line is a github "warning" admonition
+    """
+    return line.startswith("> [!WARNING]")
+
+
+def is_info(line: str) -> bool:
+    """
+    Checks if a given line is an "info" admonition
+    """
    return line.startswith("> ")


-def is_new(line):
+def is_new(line: str) -> bool:
+    """
+    Checks if a given line is a "new as of" admonition
+    """
    return line.startswith("> ") and "new as of" in line.lower()


-def is_note(line):
+def is_note(line: str) -> bool:
+    """
+    Checks if a given line is a "note" admonition
+    """
    return line.startswith("> Note:")


-def is_warning(line):
+def is_warning(line: str) -> bool:
+    """
+    Checks if a given line is a "warning" admonition
+    """
    return line.startswith("> Warning:")


-def modify_content_admonition(lines, _):
+def modify_content_admonition(lines: list[str], _) -> tuple[list[str], bool]:
+    """
+    Applies adminition info to each line in the output
+    """
    modified = False
    updated_lines = []
    admonition_lines = []
    is_admonition = False
-    for line in lines:
-        if is_info(line) or is_new(line) or is_note(line) or is_warning(line):
-            if is_new(line):
-                line = line.replace("> ", "!!! tip \"New\"\n\n    ")
-                line = line.replace("New as of", "Introduced in")
-                line = line.replace("new as of", "introduced in")
-            if is_note(line):
-                line = line.replace(
-                    "> Note: ", "!!! note \"Note\"\n\n    ")
-            elif is_warning(line):
-                line = line.replace(
-                    "> Warning: ", "!!! warning \"Warning\"\n\n    ")
-            elif is_info(line):
-                if not is_admonition:
-                    line = line.replace("> ", "!!! info \"Info\"\n\n    ")
-                elif line in [">", "> "]:
-                    line = ""
-                else:
-                    line = "    " + line.removeprefix("> ")
+    replace_new_in_next_line = False
+    for index, line in enumerate(lines):
+        next_line: str | None = None
+        if index + 1 < len(lines):
+            next_line = lines[index + 1]

+        if replace_new_in_next_line:
+            line = line.replace("New as of", "Introduced in")
+            line = line.replace("new as of", "introduced in")
+            replace_new_in_next_line = False
+
+        if is_github_new(line, next_line):
+            line = line.replace("> [!IMPORTANT]", '!!! tip "New"')
+            is_admonition = True
+            admonition_lines.append(line)
+            admonition_lines.append("")
+            replace_new_in_next_line = True
+        elif is_github_note(line):
+            line = line.replace("> [!NOTE]", '!!! note "Note"')
+            is_admonition = True
+            admonition_lines.append(line)
+            admonition_lines.append("")
+        elif is_github_warning(line):
+            line = line.replace("> [!WARNING]", '!!! warning "Warning"')
+            is_admonition = True
+            admonition_lines.append(line)
+            admonition_lines.append("")
+        elif is_new(line):
+            print("is_new")
+            line = line.replace("> ", '!!! tip "New"\n\n    ')
+            line = line.replace("New as of", "Introduced in")
+            line = line.replace("new as of", "introduced in")
+            is_admonition = True
+            admonition_lines.append(line)
+        elif is_note(line):
+            print("is_note")
+            line = line.replace("> Note: ", '!!! note "Note"\n\n    ')
+            is_admonition = True
+            admonition_lines.append(line)
+        elif is_warning(line):
+            print("is_warning")
+            line = line.replace("> Warning: ", '!!! warning "Warning"\n\n    ')
+            is_admonition = True
+            admonition_lines.append(line)
+        elif is_info(line):
+            if not is_admonition:
+                line = line.replace("> ", '!!! info "Info"\n\n    ')
+            elif line in [">", "> "]:
+                line = ""
+            else:
+                line = "    " + line.removeprefix("> ")
            is_admonition = True
            admonition_lines.append(line)
        elif is_admonition and line in [">", "> "]:
@@ -208,6 +304,7 @@ def modify_content_admonition(lines, _):
        elif line == "":
            is_admonition = False
            if len(admonition_lines) > 0:
+                modified = True
                updated_lines.extend(admonition_lines)
                admonition_lines = []
            updated_lines.append("")
@@ -216,11 +313,17 @@ def modify_content_admonition(lines, _):
    return updated_lines, modified


-def is_shell_codeblock_start(line):
+def is_shell_codeblock_start(line: str) -> bool:
+    """
+    Checks to see if a line starts a codeblock
+    """
    return line == "```shell"


-def modify_content_terminal_example(lines, _):
+def modify_content_terminal_example(lines: list[str], _) -> tuple[list[str], bool]:
+    """
+    Modifies content so that terminal output is shown appropriately
+    """
    modified = False
    updated_lines = []
    command_block = []
@@ -246,20 +349,20 @@ def modify_content_terminal_example(lines, _):
            if previous_block == "":
                updated_lines.append(line)
                continue
-            elif previous_block == "command_block":
+            if previous_block == "command_block":
                example_block.append(line)

                if in_example_block:
                    previous_block = ""
                    in_example_block = False
-                    updated_lines.append("=== \"Shell\"")
+                    updated_lines.append('=== "Shell"')
                    updated_lines.append("")
                    for command_line in command_block:
                        updated_lines.append(f"    {command_line}")
                    command_block = []

                    updated_lines.append("")
-                    updated_lines.append("=== \"Output\"")
+                    updated_lines.append('=== "Output"')
                    updated_lines.append("")
                    for example_line in example_block:
                        updated_lines.append(f"    {example_line}")
@@ -278,7 +381,7 @@ def modify_content_terminal_example(lines, _):
                    command_block = []
                    previous_block = ""
                continue
-            elif next_line_must_be == "":
+            if next_line_must_be == "":
                if line == "":
                    next_line_must_be = None
                    continue
@@ -292,6 +395,9 @@ def modify_content_terminal_example(lines, _):


 def update_markdown(src):
+    """
+    Updates all markdown files to be mkdocs compatible
+    """
    markdown_files = []
    allowed_extensions = [".md"]
    for subdir, _, files in os.walk(src):
@@ -301,7 +407,7 @@ def update_markdown(src):
            if ext in allowed_extensions:
                markdown_files.append(file_path)

-    modifiers = [
+    modifiers: list[Callable[[list[str], str], tuple[list[str], bool]]] = [
        modify_content_noop,
        modify_content_links,
        modify_content_stripspace,
@@ -311,27 +417,32 @@ def update_markdown(src):
    ]

    for file in markdown_files:
-        modified = False
+        is_modified = False
        lines = []
-        with open(file, 'r') as f:
-            lines = f.readlines()
+        with open(file, "r", encoding="utf-8") as handler:
+            lines = handler.readlines()
            for modifier in modifiers:
-                lines, m = modifier(lines, file)
-                if m:
-                    modified = True
+                lines, modified = modifier(lines, file)
+                if modified:
+                    is_modified = True

-        if modified:
-            with open(file, 'w') as fp:
-                fp.writelines(lines)
+        if is_modified:
+            with open(file, "w", encoding="utf-8") as handler:
+                handler.writelines(lines)


 def main():
+    """
+    Main command that performs doc manipulation
+    """
    print("----> Copying mkdocs.yml")
    print("      Generating navigation")
    generate_nav("/usr/src/source/mkdocs.yml", "/usr/src/app/mkdocs.yml")

    print("----> Copying docs folder")
-    update_markdown("/usr/src/source/docs",)
+    update_markdown(
+        "/usr/src/source/docs",
+    )

    if os.path.exists("/usr/src/app/docs"):
        print("      Removing old docs folder")
--- a/debian/control
+++ b/debian/control
@@ -1,11 +1,11 @@
 Package: dokku
-Version: 0.31.0
+Version: 0.31.2
 Section: web
 Priority: optional
 Architecture: amd64
-Depends: apache2-utils, locales, git, cpio, curl, man-db, netcat, sshcommand (>= 0.12.0), docker-engine-cs (>= 17.05.0) | docker-engine (>= 17.05.0) | docker-io (>= 17.05.0) | docker.io (>= 17.05.0) | docker-ce (>= 17.05.0) | docker-ee (>= 17.05.0) | moby-engine, docker-compose-plugin | moby-compose, docker-container-healthchecker (>= 0.6.4), docker-image-labeler (>= 0.2.2), lambda-builder, net-tools, netrc, software-properties-common, parallel, procfile-util (>= 0.11.0), python-software-properties | python3-software-properties, rsync, rsyslog, dos2unix, jq, unzip
-Recommends: herokuish (>= 0.7.0), bash-completion, dokku-update, dokku-event-listener
-Pre-Depends: gliderlabs-sigil, nginx (>= 1.8.0) | openresty, dnsutils, cgroupfs-mount | cgroup-lite, plugn (>= 0.3.0), sudo, python3, debconf
+Depends: apache2-utils, locales, git, cpio, curl, man-db, netcat, sshcommand (>= 0.17.1), docker-engine-cs (>= 17.05.0) | docker-engine (>= 17.05.0) | docker-io (>= 17.05.0) | docker.io (>= 17.05.0) | docker-ce (>= 17.05.0) | docker-ee (>= 17.05.0) | moby-engine, docker-compose-plugin | moby-compose, docker-container-healthchecker (>= 0.6.4), docker-image-labeler (>= 0.6.1), lambda-builder (>= 0.5.0), net-tools, netrc (>= 0.7.1), software-properties-common, parallel, procfile-util (>= 0.16.0), python-software-properties | python3-software-properties, rsync, rsyslog, dos2unix, jq, unzip
+Recommends: herokuish (>= 0.7.1), bash-completion, dokku-update, dokku-event-listener
+Pre-Depends: gliderlabs-sigil (>= 0.10.1), nginx (>= 1.8.0) | openresty, dnsutils, cgroupfs-mount | cgroup-lite, plugn (>= 0.3.0), sudo, python3, debconf
 Maintainer: Jose Diaz-Gonzalez <dokku@josediazgonzalez.com>
 Description: Docker-powered PaaS that helps build and manage the lifecycle of applications
 Dokku is an extensible, open source Platform as a Service
--- a/docs.mk
+++ b/docs.mk
@@ -1,6 +1,6 @@
 .PHONY: docs-build-image
 docs-build-image:
-	 docker build -f docs/_build/Dockerfile --progress plain -t app/mkdocs .
+	docker build -f docs/_build/Dockerfile --progress plain -t app/mkdocs .

 .PHONY: docs-build
 docs-build:
--- a/docs/_build/entrypoint
+++ b/docs/_build/entrypoint
@@ -23,17 +23,15 @@ main() {
  fi

  if [[ "$CMD" == "deps" ]]; then
-    pip freeze
-    return $?
+    exec pip freeze
  fi

  if [[ "$CMD" == "serve" ]]; then
    write-mkdocs
-    mkdocs serve -a 0.0.0.0:3487
-    return $?
+    exec mkdocs serve -a 0.0.0.0:3487
  fi

-  "$CMD" "${ARGS[@]}"
+  exec "$CMD" "${ARGS[@]}"
 }

 main "$@"
--- a/docs/_build/requirements.txt
+++ b/docs/_build/requirements.txt
@@ -1,5 +1,5 @@
 beautifulsoup4==4.12.2
-click==8.1.6
+click==8.1.7
 ghp-import==2.1.0
 importlib-metadata==6.8.0
 Jinja2==3.1.2
@@ -8,10 +8,10 @@ MarkupSafe==2.1.3
 mergedeep==1.3.4
 mkdocs==1.5.2
 mkdocs-exclude==1.0.2
-mkdocs-material==9.1.21
+mkdocs-material==9.2.3
 mkdocs-material-extensions==1.1.1
 packaging==23.1
-Pygments==2.15.1
+Pygments==2.16.1
 pymdown-extensions==10.1
 pyparsing==3.1.1
 python-dateutil==2.8.2
--- a/docs/advanced-usage/backup-recovery.md
+++ b/docs/advanced-usage/backup-recovery.md
@@ -6,7 +6,8 @@ The best plan for disaster recovery is to always keep multiple (remote) copies o

 ## TLDR

-> Warning: This method has many caveats. Please read this entire document before assuming these backups work as expected, and test your backups on a regular basis.
+> [!WARNING]
+> This method has many caveats. Please read this entire document before assuming these backups work as expected, and test your backups on a regular basis.

 ### Creating a backup

--- a/docs/advanced-usage/deployment-tasks.md
+++ b/docs/advanced-usage/deployment-tasks.md
@@ -1,5 +1,6 @@
 # Deployment Tasks

+> [!IMPORTANT]
 > New as of 0.5.0

 ## Usage
@@ -59,7 +60,6 @@ When deploying a monorepo, it may be desirable to specify the specific path of t

 For deploys via the `git:from-image` and `git:load-image` commands, the `app.json` is extracted from the configured `WORKDIR` property of the image. For all other deploys - git push, `git:from-archive`, `git:sync` - will have the `app.json` extracted directly from the source code. Both cases will respect the configured `appjson-path` property value.

-
 ```shell
 dokku app-json:set node-js-app appjson-path .dokku/app.json
 ```
@@ -84,6 +84,7 @@ dokku app-json:set --global appjson-path

 ### Displaying app-json reports for an app

+> [!IMPORTANT]
 > New as of 0.25.0

 You can get a report about the app's storage status using the `app-json:report` command:
@@ -140,7 +141,8 @@ Dokku provides limited support for the `app.json` manifest from Heroku (document
 - `scripts.dokku.postdeploy`: This is run _after_ an app's containers are scheduled. Changes made to your image are _not_ committed at this phase.
 - `scripts.postdeploy`: This is run _after_ an app's containers are scheduled. Changes made to your image are _not_ committed at this phase.

-> Warning: Any failed `app.json` deployment task will fail the deploy. In the case of either phase, a failure will not affect any running containers.
+> [!WARNING]
+> Any failed `app.json` deployment task will fail the deploy. In the case of either phase, a failure will not affect any running containers.

 The following is an example `app.json` file. Please note that only the `scripts.dokku.predeploy` and `scripts.dokku.postdeploy` tasks are supported by Dokku at this time. All other fields will be ignored and can be omitted.

@@ -158,6 +160,7 @@ The following is an example `app.json` file. Please note that only the `scripts.

 #### Procfile Release command

+> [!IMPORTANT]
 > New as of 0.14.0

 The `Procfile` also supports a special `release` command which acts in a similar way to the [Heroku Release Phase](https://devcenter.heroku.com/articles/release-phase). This command is executed _after_ an app's docker image is built, but _before_ any containers are scheduled. This is also run _after_ any command executed by `scripts.dokku.predeploy`.
@@ -170,4 +173,5 @@ release: curl https://some.external.api.service.com/deployment?state=built

 Unlike the `scripts.dokku.predeploy` command, changes made during by the `release` command are _not_ persisted to disk.

-> Warning: scaling the release command up will likely result in unspecified issues within your deployment, and is highly discouraged.
+> [!WARNING]
+> scaling the release command up will likely result in unspecified issues within your deployment, and is highly discouraged.
--- a/docs/advanced-usage/docker-options.md
+++ b/docs/advanced-usage/docker-options.md
@@ -1,5 +1,6 @@
 # Docker Container Options

+> [!IMPORTANT]
 > New as of 0.3.17

 Pass [container options](https://docs.docker.com/engine/reference/run/) to the `docker run` command  during Dokku's `build`, `deploy` and `run` phases
@@ -27,7 +28,7 @@ Dokku deploys your application in multiple "phases" and the `docker-options` plu

 Manipulation of docker options will not restart running containers. This enables multiple options to be set/unset before final application. As such, changing an app's docker options must be followed by a `dokku ps:rebuild` in order to take effect.

-More information on supported Docker options can be found here: https://docs.docker.com/engine/reference/commandline/run/.
+More information on supported Docker options can be found [here](https://docs.docker.com/engine/reference/commandline/run/).

 Container options configured via the `docker-options` plugin are not used to modify the process a container runs. Container options are the `[OPTIONS]` portion of the following, where `[CONTAINER_COMMAND]` and `[ARG]` are the process and the arguments passed to it that are launched in the created container: `docker run [OPTIONS] [CONTAINER_COMMAND] [ARG...]`. Please see the documentation for [customizing the run command](/docs/deployment/builders/dockerfiles.md#customizing-the-run-command) or use a [Procfile](/docs/deployment/builders/dockerfiles.md#procfiles-and-multiple-processes) to modify the command used by a Dockerfile-based container.

@@ -43,7 +44,8 @@ dokku docker-options:add node-js-app deploy "-v /var/log/node-js-app:/app/logs"
 dokku docker-options:add node-js-app run "-v /var/log/node-js-app:/app/logs"
 ```

-> Note: When [mounting a host directory](https://docs.docker.com/engine/reference/run/#volume-shared-filesystems) in a Dokku app you should first create that directory as user `dokku` and then mount the directory under `/app` in the container using `docker-options` as above. Otherwise the app will lack write permission in the directory.
+> [!NOTE]
+> When [mounting a host directory](https://docs.docker.com/engine/reference/run/#volume-shared-filesystems) in a Dokku app you should first create that directory as user `dokku` and then mount the directory under `/app` in the container using `docker-options` as above. Otherwise the app will lack write permission in the directory.

 ### Remove a Docker option

@@ -84,6 +86,7 @@ dokku docker-options:clear node-js-app build,run

 ### Displaying docker-options reports for an app

+> [!IMPORTANT]
 > New as of 0.8.1

 You can get a report about the app's docker-options status using the `docker-options:report` command:
--- a/docs/advanced-usage/event-logs.md
+++ b/docs/advanced-usage/event-logs.md
@@ -1,5 +1,6 @@
 # Dokku Event Logs

+> [!IMPORTANT]
 > New as of 0.3.21

 Docker provides an _events_ command to show system's real time events. Likewise, Dokku can record events as syslog entries and also provides a plugin to display the last ones.
@@ -75,4 +76,4 @@ pre-release-buildpack
 pre-release-dockerfile
 receive-app
 update
-```
+```
--- a/docs/advanced-usage/persistent-storage.md
+++ b/docs/advanced-usage/persistent-storage.md
@@ -1,5 +1,6 @@
 # Persistent Storage

+> [!IMPORTANT]
 > New as of 0.5.0

 The preferred method to mount external containers to a Dokku managed container, is to use the Dokku storage plugin.
@@ -36,7 +37,6 @@ dokku storage:list node-js-app

 The output format can also be set to `json` for programmatic access:

-
 ```shell
 dokku storage:list node-js-app --format json
 ```
@@ -53,6 +53,7 @@ dokku storage:list node-js-app --format json

 ### Creating storage directories

+> [!IMPORTANT]
 > New as of 0.25.5

 A storage directory can be created with the `storage:ensure-directory` command. This command will create a subdirectory in the recommended `/var/lib/dokku/data/storage` path - created during Dokku installation - and prepare it for use with an app.
@@ -70,16 +71,17 @@ dokku storage:ensure-directory node-js-app
 By default, permissions are set for usage with Herokuish buildpacks. These permissions can be changed via the `--chown` option according to the following table:

 - `--chown herokuish` (default): Use `32767:32767` as the folder permissions.
-  - This is used for apps deployed with Buildpacks via Herokuish.
+    - This is used for apps deployed with Buildpacks via Herokuish.
 - `--chown heroku`: Use `1000:1000` as the folder permissions.
-  - This is used for apps deployed with Cloud Native Buildpacks using the `heroku/buildpacks` builder.
+    - This is used for apps deployed with Cloud Native Buildpacks using the `heroku/buildpacks` builder.
 - `--chown packeto`: Use `2000:2000` as the folder permissions.
-  - This is used for apps deployed with Cloud Native Buildpacks using the `cloudfoundry/cnb` or `packeto` builders.
+    - This is used for apps deployed with Cloud Native Buildpacks using the `cloudfoundry/cnb` or `packeto` builders.
 - `--chown false`: Skips the `chown` call.

 Users deploying via Dockerfile will want to specify `--chown false` and manually `chown` the created directory if the user and/or group id  of the runnning process in the deployed container do not correspond to any of the above options.

-> Warning: Failing to set the correct directory ownership may result in issues in persisting files written to the mounted storage directory.
+> [!WARNING]
+> Failing to set the correct directory ownership may result in issues in persisting files written to the mounted storage directory.

 ### Mounting storage into apps

@@ -125,6 +127,7 @@ dokku ps:restart app-name

 ### Displaying storage reports for an app

+> [!IMPORTANT]
 > New as of 0.8.1

 You can get a report about the app's storage status using the `storage:report` command:
@@ -195,14 +198,17 @@ dokku docker-options:add node-js-app build "-v /tmp/python-test:/opt/test"

 You cannot use mounted volumes during the build phase of a Dockerfile deploy. This is because Docker does not support volumes when executing `docker build`.

-> Warning: **This can cause data loss** if you bind a mount under `/app` in buildpack apps as herokuish will attempt to remove the original app path during the build phase.
+> [!WARNING]
+> **This can cause data loss** if you bind a mount under `/app` in buildpack apps as herokuish will attempt to remove the original app path during the build phase.

 ## App User and Persistent Storage file ownership (buildpack apps only)

+> [!IMPORTANT]
 > New as of 0.7.1

 By default, Dokku will execute your buildpack app processes as the `herokuishuser` user. You may override this by setting the `DOKKU_APP_USER` config variable.

-> NOTE: this user must exist in your herokuish image.
+> [!NOTE]
+> this user must exist in your herokuish image.

 Additionally, the default `docker-local` scheduler that comes with Dokku will ensure your storage mounts are owned by either `herokuishuser` or the overridden value you have set in `DOKKU_APP_USER`. See the [docker-local scheduler documentation](/docs/deployment/schedulers/docker-local.md#disabling-chown-of-persistent-storage) docs for more information.
--- a/docs/advanced-usage/plugin-management.md
+++ b/docs/advanced-usage/plugin-management.md
@@ -1,5 +1,6 @@
 # Plugin Management

+> [!IMPORTANT]
 > New as of 0.4.0

 ```
@@ -35,38 +36,39 @@ dokku plugin:list

 ```
 plugn: dev
-  00_dokku-standard    0.31.0 enabled    dokku core standard plugin
-  20_events            0.31.0 enabled    dokku core events logging plugin
-  app-json             0.31.0 enabled    dokku core app-json plugin
-  apps                 0.31.0 enabled    dokku core apps plugin
-  build-env            0.31.0 enabled    dokku core build-env plugin
-  buildpacks           0.31.0 enabled    dokku core buildpacks plugin
-  certs                0.31.0 enabled    dokku core certificate management plugin
-  checks               0.31.0 enabled    dokku core checks plugin
-  common               0.31.0 enabled    dokku core common plugin
-  config               0.31.0 enabled    dokku core config plugin
-  docker-options       0.31.0 enabled    dokku core docker-options plugin
-  domains              0.31.0 enabled    dokku core domains plugin
-  enter                0.31.0 enabled    dokku core enter plugin
-  git                  0.31.0 enabled    dokku core git plugin
-  logs                 0.31.0 enabled    dokku core logs plugin
-  network              0.31.0 enabled    dokku core network plugin
-  nginx-vhosts         0.31.0 enabled    dokku core nginx-vhosts plugin
-  plugin               0.31.0 enabled    dokku core plugin plugin
-  proxy                0.31.0 enabled    dokku core proxy plugin
-  ps                   0.31.0 enabled    dokku core ps plugin
-  repo                 0.31.0 enabled    dokku core repo plugin
-  resource             0.31.0 enabled    dokku core resource plugin
-  scheduler-docker-local 0.31.0 enabled    dokku core scheduler-docker-local plugin
-  shell                0.31.0 enabled    dokku core shell plugin
-  ssh-keys             0.31.0 enabled    dokku core ssh-keys plugin
-  storage              0.31.0 enabled    dokku core storage plugin
-  tags                 0.31.0 enabled    dokku core tags plugin
-  tar                  0.31.0 enabled    dokku core tar plugin
-  trace                0.31.0 enabled    dokku core trace plugin
+  00_dokku-standard    0.31.2 enabled    dokku core standard plugin
+  20_events            0.31.2 enabled    dokku core events logging plugin
+  app-json             0.31.2 enabled    dokku core app-json plugin
+  apps                 0.31.2 enabled    dokku core apps plugin
+  build-env            0.31.2 enabled    dokku core build-env plugin
+  buildpacks           0.31.2 enabled    dokku core buildpacks plugin
+  certs                0.31.2 enabled    dokku core certificate management plugin
+  checks               0.31.2 enabled    dokku core checks plugin
+  common               0.31.2 enabled    dokku core common plugin
+  config               0.31.2 enabled    dokku core config plugin
+  docker-options       0.31.2 enabled    dokku core docker-options plugin
+  domains              0.31.2 enabled    dokku core domains plugin
+  enter                0.31.2 enabled    dokku core enter plugin
+  git                  0.31.2 enabled    dokku core git plugin
+  logs                 0.31.2 enabled    dokku core logs plugin
+  network              0.31.2 enabled    dokku core network plugin
+  nginx-vhosts         0.31.2 enabled    dokku core nginx-vhosts plugin
+  plugin               0.31.2 enabled    dokku core plugin plugin
+  proxy                0.31.2 enabled    dokku core proxy plugin
+  ps                   0.31.2 enabled    dokku core ps plugin
+  repo                 0.31.2 enabled    dokku core repo plugin
+  resource             0.31.2 enabled    dokku core resource plugin
+  scheduler-docker-local 0.31.2 enabled    dokku core scheduler-docker-local plugin
+  shell                0.31.2 enabled    dokku core shell plugin
+  ssh-keys             0.31.2 enabled    dokku core ssh-keys plugin
+  storage              0.31.2 enabled    dokku core storage plugin
+  tags                 0.31.2 enabled    dokku core tags plugin
+  tar                  0.31.2 enabled    dokku core tar plugin
+  trace                0.31.2 enabled    dokku core trace plugin
 ```

-> Warning: All plugin commands other than `plugin:list` and `plugin:help` require sudo access and must be run directly from the Dokku server.
+> [!WARNING]
+> All plugin commands other than `plugin:list` and `plugin:help` require sudo access and must be run directly from the Dokku server.

 ### Checking if a plugin is installed

@@ -78,7 +80,8 @@ dokku plugin:installed postgres

 ### 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.
+> [!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.

--- a/docs/advanced-usage/registry-management.md
+++ b/docs/advanced-usage/registry-management.md
@@ -1,5 +1,6 @@
 # Registry Management

+> [!IMPORTANT]
 > New as of 0.25.0

 ```
--- a/docs/advanced-usage/repository-management.md
+++ b/docs/advanced-usage/repository-management.md
@@ -1,5 +1,6 @@
 # Repository Management

+> [!IMPORTANT]
 > New as of 0.6.0

 ```
--- a/docs/advanced-usage/resource-management.md
+++ b/docs/advanced-usage/resource-management.md
@@ -1,5 +1,6 @@
 # Resource Management

+> [!IMPORTANT]
 > New as of 0.15.0

 ```
@@ -16,7 +17,8 @@ The resource plugin is meant to allow users to limit or reserve resources for a

 By default, Dokku allows unlimited resource access to apps deployed on a server. In some cases, it may be desirable to limit this on a per-app or per-process-type basis. The `resource` plugin allows management of both resource "limits" and resource "reservations", where each resource request type has specific meaning to the scheduler in use for a given app.

-> Warning: The meaning of a values and it's units are specific to the scheduler in use for a given app. If a value is incorrect for a scheduler, this may result in containers failing to start correctly. If a scheduler does not support a given resource type combination, it will be ignored. All resource commands require an app rebuild or deploy in order to take effect.
+> [!WARNING]
+> The meaning of a values and it's units are specific to the scheduler in use for a given app. If a value is incorrect for a scheduler, this may result in containers failing to start correctly. If a scheduler does not support a given resource type combination, it will be ignored. All resource commands require an app rebuild or deploy in order to take effect.

 Valid resource options include:

--- a/docs/appendices/0.10.0-migration-guide.md
+++ b/docs/appendices/0.10.0-migration-guide.md
@@ -4,10 +4,10 @@

 By default, Dokku will ship a PCI Compliant nginx configuration. For developers whose users are on older browsers or mobile devices, you may need to ship a custom `nginx.conf.sigil` to enable ciphers for older browsers.

-See the [nginx customization](/docs/networking/proxies/nginx/#customizing-the-nginx-configuration) docs for more details.
+See the [nginx customization](/docs/networking/proxies/nginx.md#customizing-the-nginx-configuration) docs for more details.

 ## Nginx Error Pages

 We now ship with nicer error pages by default. You are free to customize your Dokku installation via a custom `nginx.conf.sigil` to change what error pages are displayed in different circumstances.

-See the [nginx customization](/docs/networking/proxies/nginx/#customizing-the-nginx-configuration) docs for more details.
+See the [nginx customization](/docs/networking/proxies/nginx.md#customizing-the-nginx-configuration) docs for more details.
--- a/docs/appendices/0.21.0-migration-guide.md
+++ b/docs/appendices/0.21.0-migration-guide.md
@@ -8,7 +8,7 @@ The `tls` name is no longer a reserved app name, and can be used by applications

 - `git#git_deploy_branch()` is deprecated in favor of `plugn trigger git-deploy-branch`.
 - The `config` command is deprecated in favor of `config:show`.
-  - Usage of this command in conjunction with either the `--export` or `--shell` flag is deprecated in favor of `config:export --format` with the correct format value (`exports` or `shell`, respectively).
+    - Usage of this command in conjunction with either the `--export` or `--shell` flag is deprecated in favor of `config:export --format` with the correct format value (`exports` or `shell`, respectively).
 - The `nginx:build-config` command is deprecated in favor of `proxy:build-config`.

 ## Removals
--- a/docs/appendices/0.25.0-migration-guide.md
+++ b/docs/appendices/0.25.0-migration-guide.md
@@ -19,7 +19,7 @@ Before upgrading, uninstall the registry plugin via `dokku plugin:uninstall regi
 - The `dokku run` command now always removes the ephemeral container on exit. Users that need a persistent container should instead specify a `console` process type in their `Procfile` specifying an available shell (usually either `bash` or `sh`) and scale that container appropriately.
 - The `pre-deploy` plugin trigger is now called internally by Dokku. Scheduler plugins should avoid calling this trigger, as any image changes introduced by subsequent trigger calls will be ignored.
 - The default image used for Herokuish Buildpack builds is now `gliderlabs/herokuish:latest-20`, and is based on both the `heroku-20` stack as well as Ubuntu 20.04. Users that wish to stick with the old, `heroku-18`/Ubuntu 18.04 builder may specify `gliderlabs/herokuish:latest-18` as their builder image. Please see the [herokuish buildpack deployment documentation](/docs/deployment/builders/herokuish-buildpacks.md#customizing-the-buildpack-stack-builder) for more information on how to specify a custom buildpack stack builder.
-  - This change does not impact any users of Cloud Native Buildpacks.
+    - This change does not impact any users of Cloud Native Buildpacks.
 - We fixed an issue that required extracting Procfiles at the beginning of a deploy. Due to this change, a `Dockerfile` app contains a `Procfile` that does not specify a `web` process will fail to start. Usage of a `Procfile` with _only_ a `release` command should be replaced with a `scripts.dokku.postdeploy` deployment task in the `app.json` file. The alternative is to define the `web` process in the `Procfile`. See the [deployment task documentation](/docs/advanced-usage/deployment-tasks.md) for more information.

 ### Deprecations
--- a/docs/appendices/0.26.0-migration-guide.md
+++ b/docs/appendices/0.26.0-migration-guide.md
@@ -9,4 +9,4 @@

 - The `scheduler` plugin now controls the scheduler in use for deploys. Apps will have their `DOKKU_SCHEDULER` environment variables migrated to the scheduler plugin, after which that value will be removed from said app. Please see the [scheduler documentation](/docs/deployment/schedulers/scheduler-management.md) for more information.
 - The `deploy-source` metadata from `apps:report` is now no longer computed on the fly, but hydrated at deploy time via the `deploy-source-set` trigger. This value may be empty until your next deploy.
-  - Additionally, the `deploy-source` trigger has now been removed.
+    - Additionally, the `deploy-source` trigger has now been removed.
--- a/docs/appendices/0.27.0-migration-guide.md
+++ b/docs/appendices/0.27.0-migration-guide.md
@@ -3,6 +3,7 @@
 ## Changes

 - Renaming an application will now only rename domains that are associated with global domains. As an example:
+
    ```shell
    dokku domains:set-global dokku.me
    dokku apps:create node-js-app
--- a/docs/appendices/0.5.0-migration-guide.md
+++ b/docs/appendices/0.5.0-migration-guide.md
@@ -3,23 +3,23 @@
 ## `nginx-vhosts` plugin

 - The nginx-vhosts template language is now [sigil](https://github.com/gliderlabs/sigil)
-  - No need to escape literal `$` characters (or other "bash-isms")
-  - Template variables are represented as {{ .VARIABLE_NAME }}
-  - A detailed list of template variables can be found [here](/docs/networking/proxies/nginx.md#available-template-variables)
+    - No need to escape literal `$` characters (or other "bash-isms")
+    - Template variables are represented as {{ .VARIABLE_NAME }}
+    - A detailed list of template variables can be found [here](/docs/networking/proxies/nginx.md#available-template-variables)
 - A custom nginx-vhosts template must be named `nginx.conf.sigil`
-  - The default path for this custom template is the root of your repo (i.e. `/app` in the container or `WORKDIR` if defined in a dockerfile app)
-  - Dokku no longer looks for this file in `/home/dokku/node-js-app` on the Dokku server
-  - Check out an example template [here](/docs/networking/proxies/nginx.md)
+    - The default path for this custom template is the root of your repo (i.e. `/app` in the container or `WORKDIR` if defined in a dockerfile app)
+    - Dokku no longer looks for this file in `/home/dokku/node-js-app` on the Dokku server
+    - Check out an example template [here](/docs/networking/proxies/nginx.md)
 - Support for server-wide SSL certs have been dropped in favor of using the `certs` plugin
-  - `dokku certs:add node-js-app < certs.tar`
+    - `dokku certs:add node-js-app < certs.tar`
 - All domains for an SSL-enabled app will be redirected to https by default
-  - This can be overridden with a custom template
+    - This can be overridden with a custom template
 - Replaced "magic" `NO_VHOST` variable with `domains:enable/disable`
 - Simplified zero downtime control
-  - `checks:enable/disable`
+    - `checks:enable/disable`

 ## Dockerfile apps with exposed ports

 - Dockerfiles with `EXPOSE` clauses will get [all **tcp** ports proxied by default](/docs/deployment/builders/dockerfiles.md#exposed-ports)
-  - Note that nginx will proxy the same port numbers to listen publicly
-  - UDP ports can be exposed by disabling the [nginx proxy](/docs/networking/proxy-management.md) with `dokku proxy:disable node-js-app`
+    - Note that nginx will proxy the same port numbers to listen publicly
+    - UDP ports can be exposed by disabling the [nginx proxy](/docs/networking/proxy-management.md) with `dokku proxy:disable node-js-app`
--- a/docs/appendices/0.6.0-migration-guide.md
+++ b/docs/appendices/0.6.0-migration-guide.md
@@ -3,30 +3,30 @@
 ## Zero-downtime deployment

 - You can now **actually** disable zero-downtime deployments per-app and per-process-type
-  - Some config variables have been moved around
-    - `DOKKU_CHECKS_ENABLED` has been migrated to `DOKKU_CHECKS_SKIPPED`
-    - `DOKKU_CHECKS_DISABLED` is now a thing
-    - The values for the above can be a comma-separated list of process-types or the literal string `_all_`
-  - See the [updated `checks`](/docs/deployment/zero-downtime-deploys.md) docs for more info
+    - Some config variables have been moved around
+        - `DOKKU_CHECKS_ENABLED` has been migrated to `DOKKU_CHECKS_SKIPPED`
+        - `DOKKU_CHECKS_DISABLED` is now a thing
+        - The values for the above can be a comma-separated list of process-types or the literal string `_all_`
+    - See the [updated `checks`](/docs/deployment/zero-downtime-deploys.md) docs for more info

 ## Proxy port mapping

 - You can now configure host -> container proxy port mappings
-  - The UI is handled by the [proxy](/docs/networking/proxy-management.md) interface plugin by setting the `DOKKU_PROXY_PORT_MAP` config variable in the format of `scheme:host-port:container-port`. The default `nginx-vhosts` proxy plugin supports both the `http` and `https` schemes.
+    - The UI is handled by the [proxy](/docs/networking/proxy-management.md) interface plugin by setting the `DOKKU_PROXY_PORT_MAP` config variable in the format of `scheme:host-port:container-port`. The default `nginx-vhosts` proxy plugin supports both the `http` and `https` schemes.
 - Default port mappings
-  - buildpack apps will be set to `http:80:5000` and will also include `https:443:5000` if SSL is enabled.
-  - dockerfile apps with explicitly exposed ports (i.e. using the `EXPOSE` directive) will be configured with a listener on each exposed port that proxies to the same port of the deployed application container.
-    - You may override this behavior with the [`proxy:ports-*` commands](/docs/networking/proxy-management.md) or by directly setting `DOKKU_PROXY_PORT_MAP` with the `config:set` command
-    - dockerfile apps without explicitly exposed ports will behave the same as a buildpack app
-  - NOTE: These defaults **are not** automatically changed on subsequent pushes and must be manipulated with the aforementioned commands
+    - buildpack apps will be set to `http:80:5000` and will also include `https:443:5000` if SSL is enabled.
+    - dockerfile apps with explicitly exposed ports (i.e. using the `EXPOSE` directive) will be configured with a listener on each exposed port that proxies to the same port of the deployed application container.
+        - You may override this behavior with the [`proxy:ports-*` commands](/docs/networking/proxy-management.md) or by directly setting `DOKKU_PROXY_PORT_MAP` with the `config:set` command
+        - dockerfile apps without explicitly exposed ports will behave the same as a buildpack app
+    - NOTE: These defaults **are not** automatically changed on subsequent pushes and must be manipulated with the aforementioned commands

 ## Calling the `dokku` binary

 - Plugins should *not* call the `dokku` binary directly. Clients using the `--app` argument are potentially broken, amongst others, when doing so. Instead, please source the `functions` file for a given plugin when attempting to call Dokku internal functions. As a result, the following Dokku commands are no longer publicly exposed:
-  - `dokku build`
-  - `dokku receive`
-  - `dokku release`
-  - `dokku tar:build`
-  - `dokku tar:build-locked`
-  - `dokku git:build`
-  - `dokku git:build-locked`
+    - `dokku build`
+    - `dokku receive`
+    - `dokku release`
+    - `dokku tar:build`
+    - `dokku tar:build-locked`
+    - `dokku git:build`
+    - `dokku git:build-locked`
--- a/docs/appendices/0.8.0-migration-guide.md
+++ b/docs/appendices/0.8.0-migration-guide.md
@@ -2,13 +2,13 @@

 ## Domain Management

-You can now set global and app domains via `domains:set` and `domains:set-global`. See the [domains documentation](/docs/configuration/domains/) for more details.
+You can now set global and app domains via `domains:set` and `domains:set-global`. See the [domains documentation](/docs/configuration/domains.md) for more details.

 ## Plugin Uninstallation

 A new `uninstall` plugin trigger was introduced. This functionality may be in use for newer plugins, so be aware that older Dokku versions may require manual cleanup.

-See the [uninstall trigger documentation](/docs/development/plugin-triggers/#uninstall) for implementation instructions.
+See the [uninstall trigger documentation](/docs/development/plugin-triggers.md#uninstall) for implementation instructions.

 ## Deployment Tasks

--- a/docs/assets/favicons/browserconfig.xml
+++ b/docs/assets/favicons/browserconfig.xml
@@ -2,10 +2,10 @@
 <browserconfig>
  <msapplication>
    <tile>
-      <square70x70logo src="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.0/docs/assets/favicons/mstile-70x70.png"/>
-      <square150x150logo src="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.0/docs/assets/favicons/mstile-150x150.png"/>
-      <square310x310logo src="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.0/docs/assets/favicons/mstile-310x310.png"/>
-      <wide310x150logo src="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.0/docs/assets/favicons/mstile-310x150.png"/>
+      <square70x70logo src="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.2/docs/assets/favicons/mstile-70x70.png"/>
+      <square150x150logo src="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.2/docs/assets/favicons/mstile-150x150.png"/>
+      <square310x310logo src="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.2/docs/assets/favicons/mstile-310x310.png"/>
+      <wide310x150logo src="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.2/docs/assets/favicons/mstile-310x150.png"/>
      <TileColor>#da532c</TileColor>
    </tile>
  </msapplication>
--- a/docs/assets/favicons/manifest.json
+++ b/docs/assets/favicons/manifest.json
@@ -2,37 +2,37 @@
    "name": "Dokku",
    "icons": [
        {
-            "src": "https:\/\/cdn.jsdelivr.net\/dokku\/dokku@v0.31.0\/docs\/assets\/favicons\/android-chrome-36x36.png",
+            "src": "https:\/\/cdn.jsdelivr.net\/dokku\/dokku@v0.31.2\/docs\/assets\/favicons\/android-chrome-36x36.png",
            "sizes": "36x36",
            "type": "image\/png",
            "density": "0.75"
        },
        {
-            "src": "https:\/\/cdn.jsdelivr.net\/dokku\/dokku@v0.31.0\/docs\/assets\/favicons\/android-chrome-48x48.png",
+            "src": "https:\/\/cdn.jsdelivr.net\/dokku\/dokku@v0.31.2\/docs\/assets\/favicons\/android-chrome-48x48.png",
            "sizes": "48x48",
            "type": "image\/png",
            "density": "1.0"
        },
        {
-            "src": "https:\/\/cdn.jsdelivr.net\/dokku\/dokku@v0.31.0\/docs\/assets\/favicons\/android-chrome-72x72.png",
+            "src": "https:\/\/cdn.jsdelivr.net\/dokku\/dokku@v0.31.2\/docs\/assets\/favicons\/android-chrome-72x72.png",
            "sizes": "72x72",
            "type": "image\/png",
            "density": "1.5"
        },
        {
-            "src": "https:\/\/cdn.jsdelivr.net\/dokku\/dokku@v0.31.0\/docs\/assets\/favicons\/android-chrome-96x96.png",
+            "src": "https:\/\/cdn.jsdelivr.net\/dokku\/dokku@v0.31.2\/docs\/assets\/favicons\/android-chrome-96x96.png",
            "sizes": "96x96",
            "type": "image\/png",
            "density": "2.0"
        },
        {
-            "src": "https:\/\/cdn.jsdelivr.net\/dokku\/dokku@v0.31.0\/docs\/assets\/favicons\/android-chrome-144x144.png",
+            "src": "https:\/\/cdn.jsdelivr.net\/dokku\/dokku@v0.31.2\/docs\/assets\/favicons\/android-chrome-144x144.png",
            "sizes": "144x144",
            "type": "image\/png",
            "density": "3.0"
        },
        {
-            "src": "https:\/\/cdn.jsdelivr.net\/dokku\/dokku@v0.31.0\/docs\/assets\/favicons\/android-chrome-192x192.png",
+            "src": "https:\/\/cdn.jsdelivr.net\/dokku\/dokku@v0.31.2\/docs\/assets\/favicons\/android-chrome-192x192.png",
            "sizes": "192x192",
            "type": "image\/png",
            "density": "4.0"
--- a/docs/assets/versions.json
+++ b/docs/assets/versions.json
@@ -28,6 +28,6 @@
    "0.28.4",
    "0.29.4",
    "0.30.11",
-    "0.31.0"
+    "0.31.2"
  ]
 }
--- a/docs/community/plugins.md
+++ b/docs/community/plugins.md
@@ -46,7 +46,8 @@ The following plugins are available and provided by Dokku maintainers.  Please f

 ## Community plugins

-> Warning: The following plugins have been supplied by our community and may not have been tested by Dokku maintainers.
+> [!WARNING]
+> The following plugins have been supplied by our community and may not have been tested by Dokku maintainers.

 ### Datastores

@@ -116,12 +117,12 @@ The following plugins are available and provided by Dokku maintainers.  Please f
 | [Open App Ports](https://github.com/josegonzalez/dokku-ports)                                     | [josegonzalez][]      | 0.3.x                 |
 | [Proctype Filter](https://github.com/michaelshobbs/dokku-proctype-filter)                         | [michaelshobbs][]     | 0.4.0+                |
 | [robots.txt](https://notabug.org/candlewaster/dokku-robots.txt)                                   | [candlewaster][]      | 0.4.x                 |
-| [SSH Deployment Keys](https://github.com/cedricziel/dokku-deployment-keys)<sup>2</sup>            | [cedricziel][]        | 0.4.0+                |
-| [SSH Hostkeys](https://github.com/cedricziel/dokku-hostkeys-plugin)<sup>3</sup>                   | [cedricziel][]        | 0.3.x                 |
+| [SSH Deployment Keys](https://github.com/cedricziel/dokku-deployment-keys)<sup>3</sup>            | [cedricziel][]        | 0.4.0+                |
+| [SSH Hostkeys](https://github.com/cedricziel/dokku-hostkeys-plugin)<sup>4</sup>                   | [cedricziel][]        | 0.3.x                 |
 | [Application build hook](https://github.com/fteychene/dokku-build-hook)                           | [fteychene][]         | 0.4.0+                |
 | [Post Deploy Script](https://github.com/baikunz/dokku-post-deploy-script)                         | [baikunz][]           | 0.4.0+                |
-| [Auto Sync](https://github.com/IdeaSynthesis/dokku-autosync)<sup>4</sup>                          | [fomojola][]          | 0.8.1+                |
-| [Deploy Webhook](https://github.com/IdeaSynthesis/dokku-deploy-webhook)<sup>5</sup>               | [fomojola][]          | 0.8.1+                |
+| [Auto Sync](https://github.com/IdeaSynthesis/dokku-autosync)<sup>5</sup>                          | [fomojola][]          | 0.8.1+                |
+| [Deploy Webhook](https://github.com/IdeaSynthesis/dokku-deploy-webhook)<sup>6</sup>               | [fomojola][]          | 0.8.1+                |

 <sup>1</sup> Extends app.json support to include creating volumes and creating / linking databases on push

@@ -208,7 +209,7 @@ The following plugins have been removed as their functionality is now in Dokku C
 | [Volume (persistent storage)](https://github.com/ohardy/dokku-volume)                             | [ohardy][]            | v0.5.0 (storage plugin)                   |

 <sup>1</sup> Conflicts with [VHOSTS Custom Configuration](https://github.com/neam/dokku-nginx-vhosts-custom-configuration)
-<sup>2</sup> Similar to the heroku-labs feature (see https://devcenter.heroku.com/articles/labs-user-env-compile)
+<sup>2</sup> Similar to the [heroku-labs feature](https://devcenter.heroku.com/articles/labs-user-env-compile)

 ### Unmaintained Plugins

--- a/docs/configuration/domains.md
+++ b/docs/configuration/domains.md
@@ -1,5 +1,6 @@
 # Domain Configuration

+> [!IMPORTANT]
 > New as of 0.3.10

 ```
@@ -65,6 +66,7 @@ dokku domains:set node-js-app dokku.me dokku.org

 ## Displaying domains reports for an app

+> [!IMPORTANT]
 > New as of 0.8.1

 You can get a report about the app's domains status using the `domains:report` command:
--- a/docs/configuration/environment-variables.md
+++ b/docs/configuration/environment-variables.md
@@ -14,13 +14,15 @@ config:keys (<app>|--global) [--merged]
 config:set [--encoded] [--no-restart] (<app>|--global) KEY1=VALUE1 [KEY2=VALUE2 ...]  Set one or more config vars
 config:unset [--no-restart] (<app>|--global) KEY1 [KEY2 ...]                          Unset one or more config vars
 ```
+
 > For security reasons - and as per [docker recommendations](https://github.com/docker/docker/issues/13490) - Dockerfile-based deploys have variables available _only_ during runtime, as noted in [this issue](https://github.com/dokku/dokku/issues/1860). Consider using [build arguments](/docs/deployment/builders/dockerfiles.md#build-time-configuration-variables) to expose variables during build-time for Dockerfile apps.

 Environment variables are available both at run time and during the application build/compilation step for buildpack-based deploys.

 For buildpack deploys, Dokku will create a  `/app/.env` file that can be used for legacy buildpacks. Note that this is _not_ updated when `config:set` or `config:unset` is called, and is only written during a `deploy` or `ps:rebuild`. Developers are encouraged to instead read from the application environment directly, as the proper values will be available then.

-> Note: Global `ENV` files are sourced before app-specific `ENV` files. This means that app-specific variables will take precedence over global variables. Configuring your global `ENV` file is manual, and should be considered potentially dangerous as configuration applies to all applications.
+> [!NOTE]
+> Global `ENV` files are sourced before app-specific `ENV` files. This means that app-specific variables will take precedence over global variables. Configuring your global `ENV` file is manual, and should be considered potentially dangerous as configuration applies to all applications.

 You can set multiple environment variables at once:

@@ -28,7 +30,8 @@ You can set multiple environment variables at once:
 dokku config:set node-js-app ENV=prod COMPILE_ASSETS=1
 ```

-> Note: Whitespace and special characters get tricky. If you are using dokku locally you don't need to do any special escaping. If you are using dokku over ssh you will need to backslash-escape spaces:
+Whitespace and special characters get tricky. If you are using dokku locally you don't need to do any special escaping. If you are using dokku over ssh you will need to backslash-escape spaces:
+
 ```shell
 dokku config:set node-js-app KEY="VAL\ WITH\ SPACES"
 ```
@@ -58,8 +61,7 @@ dokku config:export node-js-app
 eval $(dokku config:export node-js-app)
 ```

-You can control the format of the exported variables with the `--format` flag. 
-`--format=shell` will output the variables in a single-line for usage in command-line utilities:
+You can control the format of the exported variables with the `--format` flag. `--format=shell` will output the variables in a single-line for usage in command-line utilities:

 ```shell
 dokku config:export --format shell node-js-app
@@ -73,7 +75,8 @@ dokku config:export --format shell node-js-app

 The following config variables have special meanings and can be set in a variety of ways. Unless specified via global app config, the values may not be passed into applications. Usage of these values within applications should be considered unsafe, as they are an internal configuration values that may be moved to the internal properties system in the future.

-> Warning: This list is not exhaustive, and may vary from version to version.
+> [!WARNING]
+> This list is not exhaustive, and may vary from version to version.

 | Name                           | Default                         | How to modify                                                                                                                                    | Description                                                                                                |
 | ------------------------------ | ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------- |
--- a/docs/configuration/ssl.md
+++ b/docs/configuration/ssl.md
@@ -1,5 +1,6 @@
 # SSL Configuration

+> [!IMPORTANT]
 > New as of 0.4.0

 Dokku supports SSL/TLS certificate inspection and CSR/Self-signed certificate generation via the `certs` plugin. Note that whenever SSL/TLS support is enabled SPDY is also enabled.
@@ -33,7 +34,8 @@ tar cvf cert-key.tar server.crt server.key
 dokku certs:add node-js-app < cert-key.tar
 ```

-> Note: If your `.crt` file came alongside a `.ca-bundle`, you'll want to concatenate those into a single `.crt` file before adding it to the `.tar`.
+> [!NOTE]
+> If your `.crt` file came alongside a `.ca-bundle`, you'll want to concatenate those into a single `.crt` file before adding it to the `.tar`.

 ```shell
 cat yourdomain_com.crt yourdomain_com.ca-bundle > server.crt
@@ -47,7 +49,8 @@ Note that with the default nginx template, requests will be redirected to the `h

 ### Certificate generation

-> Note: Using this method will create a self-signed certificate, which is only recommended for development or staging use, not production environments.
+> [!NOTE]
+> Using this method will create a self-signed certificate, which is only recommended for development or staging use, not production environments.

 The `certs:generate` command will walk you through the correct `openssl` commands to create a key, csr and a self-signed cert for a given app/domain. We automatically put the self-signed cert in place as well as add the specified domain to the application configuration.

@@ -69,6 +72,7 @@ dokku certs:show node-js-app key > server.key

 ### Displaying certificate reports for an app

+> [!IMPORTANT]
 > New as of 0.8.1

 You can get a report about the apps ssl status using the `certs:report` command:
--- a/docs/deployment/application-deployment.md
+++ b/docs/deployment/application-deployment.md
@@ -1,6 +1,7 @@
 # Deploying an Application

-> Note: This walkthrough uses the hostname `dokku.me` in commands. When deploying to your own server, you should substitute the domain `dokku.me` for the domain name or IP address associated with your server. Users of the Vagrant VM included with Dokku can use `dokku.me` which points to the IP of the VM.
+> [!NOTE]
+> This walkthrough uses the hostname `dokku.me` in commands. When deploying to your own server, you should substitute the domain `dokku.me` for the domain name or IP address associated with your server. Users of the Vagrant VM included with Dokku can use `dokku.me` which points to the IP of the VM.

 ## Deploy tutorial

@@ -52,7 +53,8 @@ Dokku supports linking a single service to multiple applications as well as link

 ### Deploy the app

-> Warning: Your app should respect the `PORT` environment variable, otherwise it may not respond to web requests. You can find more information in the [port management documentation](/docs/networking/port-management.md).**
+> [!WARNING]
+> Your app should respect the `PORT` environment variable, otherwise it may not respond to web requests. You can find more information in the [port management documentation](/docs/networking/port-management.md).**

 Now you can deploy the `ruby-getting-started` app to your Dokku server. All you have to do is add a remote to name the app. Applications are created on-the-fly on the Dokku server.

@@ -64,11 +66,13 @@ git remote add dokku dokku@dokku.me:ruby-getting-started
 git push dokku main
 ```

-> Note: Some tools may not support the short-upstream syntax referenced above, and you may need to prefix
+> [!NOTE]
+> Some tools may not support the short-upstream syntax referenced above, and you may need to prefix
 > the upstream with the scheme `ssh://` like so: `ssh://dokku@dokku.me:ruby-getting-started`
 > Please see the [Git](https://git-scm.com/docs/git-clone#_git_urls_a_id_urls_a) documentation for more details.

-> Note: Your private key should be registered with `ssh-agent` in your local development environment. If you get a `permission denied` error when pushing, you can register your private key as follows: `ssh-add -k ~/<your private key>`.
+> [!NOTE]
+> Your private key should be registered with `ssh-agent` in your local development environment. If you get a `permission denied` error when pushing, you can register your private key as follows: `ssh-add -k ~/<your private key>`.

 After running `git push dokku main`, you should have output similar to this in your terminal:

@@ -102,7 +106,7 @@ Once the deploy is complete, the application's web URL will be generated as abov
 Dokku supports deploying applications in a few ways:

 - [Heroku buildpacks](https://devcenter.heroku.com/articles/buildpacks) via [Herokuish](https://github.com/gliderlabs/herokuish#buildpacks): See the [herokuish buildpacks documentation](/docs/deployment/builders/herokuish-buildpacks.md) to learn about the different ways to specify a buildpack.
-  - This is the default method used by Dokku.
+    - This is the default method used by Dokku.
 - [Dockerfile](https://docs.docker.com/reference/builder/): See the [dockerfile documentation](/docs/deployment/builders/dockerfiles.md) to learn about the different ways to configure Dockerfile-based deploys.
 - [Docker Image](https://docs.docker.com/get-started/overview/#docker-objects): See the [docker image documentation](/docs/deployment/methods/git.md#initializing-an-app-repository-from-a-docker-image) to learn about how to deploy a Docker Image.

@@ -148,7 +152,7 @@ dokku config:set ruby-getting-started DOKKU_SKIP_DEPLOY=true

 ### Redeploying or restarting

-If you need to redeploy or restart your app: 
+If you need to redeploy or restart your app:

 ```shell
 # on the Dokku host
@@ -168,7 +172,8 @@ ssh-keyscan -t rsa github.com >> ~/.ssh/known_hosts
 ssh -T git@github.com
 ```

-> Warning: if the buildpack or Dockerfile build process require SSH key access for other reasons, the above may not always apply.
+> [!WARNING]
+> if the buildpack or Dockerfile build process require SSH key access for other reasons, the above may not always apply.

 ## Deploying to subdomains

--- a/docs/deployment/application-management.md
+++ b/docs/deployment/application-management.md
@@ -1,5 +1,6 @@
 # Application Management

+> [!IMPORTANT]
 > New as of 0.3.1

 ```
@@ -19,6 +20,7 @@ apps:unlock <app>                              # Unlocks an app for deployment

 ### Listing applications

+> [!IMPORTANT]
 > New as of 0.8.1. Use the `apps` command for older versions.

 You can easily list all available applications using the `apps:list` command:
@@ -117,6 +119,7 @@ Destroying an application will unlink all linked services and destroy any config

 ### Renaming a deployed app

+> [!IMPORTANT]
 > New as of 0.4.7

 You can rename a deployed app using the `apps:rename` command. Note that the application *must* have been deployed at least once, or the rename will not complete successfully:
@@ -158,6 +161,7 @@ git remote set-url dokku dokku@dokku.me:io-js-app

 ### Cloning an existing app

+> [!IMPORTANT]
 > New as of 0.11.5

 You can clone an existing app using the `apps:clone` command.  Note that the application *must* have been deployed at least once, or cloning will not complete successfully:
@@ -177,7 +181,8 @@ This will copy all of your app's contents into a new app directory with the name
 - SSL certificates will not be copied to the new app.
 - Port mappings with the scheme `https` and host-port `443` will be skipped.

-> Warning: If you have exposed specific ports via `docker-options` plugin, or performed anything that cannot be done against multiple applications, `apps:clone` may result in errors.
+> [!WARNING]
+> If you have exposed specific ports via `docker-options` plugin, or performed anything that cannot be done against multiple applications, `apps:clone` may result in errors.

 By default, Dokku will deploy this new app, though you can skip the deploy by using the `--skip-deploy` flag:

@@ -193,6 +198,7 @@ dokku apps:clone --ignore-existing node-js-app io-js-app

 ### Locking app deploys

+> [!IMPORTANT]
 > New as of 0.11.6

 If you wish to disable deploying for a period of time, this can be done via deploy locks. Normally, deploy locks exist only for the duration of a deploy so as to avoid deploys from colliding, but a deploy lock can be created by running the `apps:lock` command.
@@ -207,11 +213,13 @@ dokku apps:lock node-js-app

 ### Unlocking app deploys

+> [!IMPORTANT]
 > New as of 0.11.6

 In some cases, it may be necessary to remove an existing deploy lock. This can be performed via the `apps:unlock` command.

-> Warning: Removing the deploy lock *will not* stop in progress deploys. At this time, in progress deploys will need to be manually terminated by someone with server access.
+> [!WARNING]
+> Removing the deploy lock *will not* stop in progress deploys. At this time, in progress deploys will need to be manually terminated by someone with server access.

 ```shell
 dokku apps:unlock node-js-app
@@ -225,6 +233,7 @@ dokku apps:unlock node-js-app

 ### Checking lock status

+> [!IMPORTANT]
 > New as of 0.13.0

 In some cases, you may wish to inspect the state of an app lock. To do so, you can issue an `apps:lock` command. This will exit non-zero if there is no app lock in place.
@@ -239,6 +248,7 @@ Deploy lock does not exist

 ### Displaying reports for an app

+> [!IMPORTANT]
 > New as of 0.8.1

 You can get a report about the deployed apps using the `apps:report` command:
--- a/docs/deployment/builders/builder-management.md
+++ b/docs/deployment/builders/builder-management.md
@@ -1,5 +1,6 @@
 # Builder Management

+> [!IMPORTANT]
 > New as of 0.24.0

 ```
@@ -51,7 +52,8 @@ dokku builder:set --global selected

 #### Changing the build directory

-> Warning: Please keep in mind that setting a custom build directory will result in loss of any changes to the top-level directory, such as the `git.keep-git-dir` property.
+> [!WARNING]
+> Please keep in mind that setting a custom build directory will result in loss of any changes to the top-level directory, such as the `git.keep-git-dir` property.

 When deploying a monorepo, it may be desirable to specify the specific build directory to use for a given app. This can be done via the `builder:set` command. If a value is specified and that directory does not exist within the repository, the build will fail.

@@ -131,14 +133,14 @@ dokku builder:report node-js-app --builder-selected
 To create a custom builder, the following triggers must be implemented:

 - `builder-build`:
-  - arguments: `BUILDER_TYPE` `APP` `SOURCECODE_WORK_DIR`
-  - description: Creates a docker image named with the output of `common#get_app_image_name $APP`.
+    - arguments: `BUILDER_TYPE` `APP` `SOURCECODE_WORK_DIR`
+    - description: Creates a docker image named with the output of `common#get_app_image_name $APP`.
 - `builder-detect`:
-  - arguments: `APP` `SOURCECODE_WORK_DIR`
-  - description: Outputs the name of the builder (without the `builder-` prefix) to use to build the app.
+    - arguments: `APP` `SOURCECODE_WORK_DIR`
+    - description: Outputs the name of the builder (without the `builder-` prefix) to use to build the app.
 - `builder-release`:
-  - arguments: `BUILDER_TYPE` `APP` `IMAGE_AG`
-  - description: A post-build, pre-release trigger that can be used to post-process the image. Usually simply tags and labels the image appropriately.
+    - arguments: `BUILDER_TYPE` `APP` `IMAGE_AG`
+    - description: A post-build, pre-release trigger that can be used to post-process the image. Usually simply tags and labels the image appropriately.

 Custom plugins names _must_ have the prefix `builder-` or builder overriding via `builder:set` may not function as expected.

--- a/docs/deployment/builders/cloud-native-buildpacks.md
+++ b/docs/deployment/builders/cloud-native-buildpacks.md
@@ -1,5 +1,6 @@
 # Cloud Native Buildpacks

+> [!IMPORTANT]
 > New as of 0.22.0

 ```
@@ -13,7 +14,8 @@ buildpacks:set-property [--global|<app>] <key> <value>  # Set or clear a buildpa

 Cloud Native Buildpacks are an evolution over the Buildpacks technology provided by the Herokuish builder. See the [herokuish buildpacks documentation](/docs/deployment/builders/herokuish-buildpacks.md) for more information on how to clear buildpack build cache for an application.

-> Warning: This functionality uses the `pack` cli from the [Cloud Native Buildpacks](https://buildpacks.io) project to build apps. As the integration is experimental in Dokku, it is likely to change over time.
+> [!WARNING]
+> This functionality uses the `pack` cli from the [Cloud Native Buildpacks](https://buildpacks.io) project to build apps. As the integration is experimental in Dokku, it is likely to change over time.

 ## Usage

@@ -28,25 +30,27 @@ Builds will proceed with the `pack` cli for the app from then on.
 As this functionality is highly experimental, there are a number of caveats. Please note that not all issuesare listed below.

 - Specifying specific buildpacks is not currently possible.
-  - A future release will add support for specifying buildpacks via the `buildpacks` plugin.
+    - A future release will add support for specifying buildpacks via the `buildpacks` plugin.
 - There is currently no way to specify extra arguments for `pack` cli invocations.
-  - A future release will add support for injecting extra arguments during the build process.
+    - A future release will add support for injecting extra arguments during the build process.
 - The default process type is `web`.
 - Build cache is stored in Docker volumes instead of on disk. As such, `repo:purge-cache` currently has no effect.
-  - A future version will add integration with the `repo` plugin.
+    - A future version will add integration with the `repo` plugin.
 - `pack` is not currently included with Dokku, nor is it added as a package dependency.
-  - A future version will include it as a package dependency.
+    - A future version will include it as a package dependency.

 ### Detection

 This builder will be auto-detected in either the following cases:

 - The `DOKKU_CNB_EXPERIMENTAL` app environment variable is set to `1`.
-  ```shell
-  dokku config:set --no-restart node-js-app DOKKU_CNB_EXPERIMENTAL=1
-  ```
+
+    ```shell
+    dokku config:set --no-restart node-js-app DOKKU_CNB_EXPERIMENTAL=1
+    ```
+
 - A `project.toml` file exists in the root of the app repository.
-  - This file is consumed by `pack-cli` and used to describe how the app is built.
+    - This file is consumed by `pack-cli` and used to describe how the app is built.

 The builder can also be specified via the `builder:set` command:

@@ -86,6 +90,7 @@ dokku builder-pack:set --global projecttoml-path

 ### Displaying builder-pack reports for an app

+> [!IMPORTANT]
 > New as of 0.25.0

 You can get a report about the app's storage status using the `builder-pack:report` command:
@@ -134,6 +139,7 @@ project2.toml

 ### Customizing the Buildpack stack builder

+> [!IMPORTANT]
 > New as of 0.23.0

 The default stack builder in use by CNB buildpacks in Dokku is based on `heroku/builder:22`. Users may desire to switch the stack builder to a custom version, either to update the operating system or to customize packages included with the stack builder. This can be performed via the `buildpacks:set-property` command.
--- a/docs/deployment/builders/dockerfiles.md
+++ b/docs/deployment/builders/dockerfiles.md
@@ -1,5 +1,6 @@
 # Dockerfile Deployment

+> [!IMPORTANT]
 > New as of 0.3.15

 ```
@@ -64,6 +65,7 @@ dokku builder-dockerfile:set --global dockerfile-path

 ### Displaying builder-dockerfile reports for an app

+> [!IMPORTANT]
 > New as of 0.25.0

 You can get a report about the app's storage status using the `builder-dockerfile:report` command:
@@ -196,6 +198,7 @@ Setting `$DOKKU_DOCKERFILE_CACHE_BUILD` to `true` or `false` will enable or disa

 ### Procfiles and multiple processes

+> [!IMPORTANT]
 > New as of 0.5.0

 See the [Procfile documentation](/docs/processes/process-management.md#procfile) for more information on how to specify different processes for your app.
--- a/docs/deployment/builders/herokuish-buildpacks.md
+++ b/docs/deployment/builders/herokuish-buildpacks.md
@@ -1,5 +1,6 @@
 # Herokuish Buildpacks

+> [!IMPORTANT]
 > Subcommands new as of 0.15.0

 ```
@@ -17,14 +18,15 @@ builder-herokuish:report [<app>] [<flag>]   # Displays a builder-herokuish repor
 builder-herokuish:set <app> <key> (<value>) # Set or clear a builder-herokuish property for an app
 ```

-> Warning: If using the `buildpacks` plugin, be sure to unset any `BUILDPACK_URL` and remove any such entries from a committed `.env` file. A specified `BUILDPACK_URL` will always override a `.buildpacks` file or the buildpacks plugin.
+> [!WARNING]
+> If using the `buildpacks` plugin, be sure to unset any `BUILDPACK_URL` and remove any such entries from a committed `.env` file. A specified `BUILDPACK_URL` will always override a `.buildpacks` file or the buildpacks plugin.

 Dokku normally defaults to using [Heroku buildpacks](https://devcenter.heroku.com/articles/buildpacks) for deployment, though this may be overridden by committing a valid `Dockerfile` to the root of your repository and pushing the repository to your Dokku installation. To avoid this automatic `Dockerfile` deployment detection, you may do one of the following:

 - Set a `BUILDPACK_URL` environment variable
-  - This can be done via `dokku config:set` or via a committed `.env` file in the root of the repository. See the [environment variable documentation](/docs/configuration/environment-variables.md) for more details.
+    - This can be done via `dokku config:set` or via a committed `.env` file in the root of the repository. See the [environment variable documentation](/docs/configuration/environment-variables.md) for more details.
 - Create a `.buildpacks` file in the root of your repository.
-  - This can be via a committed `.buildpacks` file or managed via the `buildpacks` plugin commands.
+    - This can be via a committed `.buildpacks` file or managed via the `buildpacks` plugin commands.

 This page will cover usage of the `buildpacks` plugin.

@@ -35,9 +37,9 @@ This page will cover usage of the `buildpacks` plugin.
 This builder will be auto-detected in either the following cases:

 - The `BUILDPACK_URL` app environment variable is set.
-  - This can be done via `dokku config:set` or via a committed `.env` file in the root of the repository. See the [environment variable documentation](/docs/configuration/environment-variables.md) for more details.
+    - This can be done via `dokku config:set` or via a committed `.env` file in the root of the repository. See the [environment variable documentation](/docs/configuration/environment-variables.md) for more details.
 - A `.buildpacks` file exists in the root of the app repository.
-  - This can be via a committed `.buildpacks` file or managed via the `buildpacks` plugin commands.
+    - This can be via a committed `.buildpacks` file or managed via the `buildpacks` plugin commands.

 The builder can also be specified via the `builder:set` command:

@@ -147,6 +149,7 @@ dokku buildpacks:clear node-js-app

 ### Customizing the Buildpack stack builder

+> [!IMPORTANT]
 > New as of 0.23.0

 The default stack builder in use by Herokuish buildpacks in Dokku is based on `gliderlabs/herokuish:latest`. Typically, this is installed via an OS package which pulls the requisite Docker image. Users may desire to switch the stack builder to a custom version, either to update the operating system or to customize packages included with the stack builder. This can be performed via the `buildpacks:set-property` command.
@@ -175,6 +178,7 @@ dokku buildpacks:set-property --global stack

 ### Allowing herokuish for non-amd64 platforms

+> [!IMPORTANT]
 > New as of 0.29.0

 By default, the builder-herokuish plugin is not enabled for non-amd64 platforms, and attempting to use it is blocked. This is because the majority of buildpacks are not cross-platform compatible, and thus building apps will either be considerably slower - due to emulating the amd64 platform - or won't work - due to building amd64 packages on arm/arm64 platforms.
@@ -248,6 +252,7 @@ dokku buildpacks:report node-js-app --buildpacks-list

 ### Displaying builder-herokuish reports for an app

+> [!IMPORTANT]
 > New as of 0.29.0

 You can get a report about the app's storage status using the `builder-herokuish:report` command:
--- a/docs/deployment/builders/lambda.md
+++ b/docs/deployment/builders/lambda.md
@@ -1,5 +1,6 @@
 # Lambda Builder

+> [!IMPORTANT]
 > New as of 0.28.0

 ```
--- a/docs/deployment/builders/null.md
+++ b/docs/deployment/builders/null.md
@@ -1,5 +1,6 @@
 # Null Builder

+> [!IMPORTANT]
 > New as of 0.25.0

 The `null` builder does nothing, and is useful for routing to services not managed by Dokku. It should not be used in normal operation. Please see the [network documentation](/docs/networking/network.md#routing-an-app-to-a-known-ip:port-combination) for more information on the aforementioned use case.
--- a/docs/deployment/logs.md
+++ b/docs/deployment/logs.md
@@ -43,7 +43,8 @@ The above command will show logs continually from the web process.

 ### Failed deploy logs

-> Warning: The default [docker-local scheduler](/docs/deployment/schedulers/docker-local.md) will "store" these until the next deploy or until the old containers are garbage collected - whichever runs first. If you require the logs beyond this point in time, please ship the logs to a centralized log server.
+> [!WARNING]
+> The default [docker-local scheduler](/docs/deployment/schedulers/docker-local.md) will "store" these until the next deploy or until the old containers are garbage collected - whichever runs first. If you require the logs beyond this point in time, please ship the logs to a centralized log server.

 In some cases, it may be useful to retrieve the logs from a previously failed deploy.

@@ -89,13 +90,15 @@ dokku logs:set --global max-size

 ### Vector Logging Shipping

+> [!IMPORTANT]
 > New as of 0.22.6

 Vector is an open-source, lightweight and ultra-fast tool for building observability pipelines. Dokku integrates with it for shipping container logs for the `docker-local` scheduler. Users may configure log-shipping on a per-app or global basis, neither of which interfere with the `dokku logs` commands.

 #### Starting the Vector container

-> Warning: While the default vector image may be updated over time, this will not impact running vector containers. Users are encouraged to view any Dokku and Vector changelogs to ensure their system will continue running as expected.
+> [!WARNING]
+> While the default vector image may be updated over time, this will not impact running vector containers. Users are encouraged to view any Dokku and Vector changelogs to ensure their system will continue running as expected.

 Vector may be started via the `logs:vector-start` command.

--- a/docs/deployment/methods/git.md
+++ b/docs/deployment/methods/git.md
@@ -1,5 +1,6 @@
 # Git Deployment

+> [!IMPORTANT]
 > Subcommands new as of 0.12.0

 ```
@@ -25,7 +26,8 @@ Git-based deployment has been the traditional method of deploying applications i

 ## Usage

-> Warning: Pushing from a shallow clone is not currently supported and may have undefined behavior. Please unshallow your local repository before pushing to a Dokku app to avoid potential errors in the deployment process.
+> [!WARNING]
+> Pushing from a shallow clone is not currently supported and may have undefined behavior. Please unshallow your local repository before pushing to a Dokku app to avoid potential errors in the deployment process.

 ### Initializing an application

@@ -38,9 +40,10 @@ When an application is created via `git push`, Dokku will create the proper `pre
 dokku git:initialize node-js-app
 ```

-In order for the above command to succeed, the application _must_ already exist. 
+In order for the above command to succeed, the application _must_ already exist.

-> Warning: If the `pre-receive` hook was customized in any way, this will overwrite that hook with the current defaults for Dokku.
+> [!WARNING]
+> If the `pre-receive` hook was customized in any way, this will overwrite that hook with the current defaults for Dokku.

 ### Changing the deploy branch

@@ -72,6 +75,7 @@ Pushing multiple branches can also be supported by creating a [receive-branch](/

 ### Configuring the `GIT_REV` environment variable

+> [!IMPORTANT]
 > New as of 0.12.0

 Application deployments will include a special `GIT_REV` environment variable containing the current deployment sha being deployed. For rebuilds, this SHA will remain the same.
@@ -123,6 +127,7 @@ Please keep in mind that setting `keep-git-dir` to `true` may result in unstaged

 ### Initializing an app repository from a docker image

+> [!IMPORTANT]
 > New as of 0.24.0

 A Dokku app repository can be initialized or updated from a Docker image via the `git:from-image` command. This command will either initialize the app repository or update it to include the specified Docker image via a `FROM` stanza. This is an excellent way of tracking changes when deploying only a given docker image, especially if deploying an image from a remote CI/CD pipeline.
@@ -170,6 +175,7 @@ See the [dockerfile documentation](/docs/deployment/builders/dockerfiles.md) to

 ### Initializing an app repository from an archive file

+> [!IMPORTANT]
 > New as of 0.24.0

 A Dokku app repository can be initialized or updated from the contents of an archive file via the `git:from-archive` command. This is an excellent way of tracking changes when deploying pre-built binary archives, such as java jars or go binaries. This can also be useful when deploying directly from a GitHub repository at a specific commit.
@@ -202,6 +208,7 @@ curl -sSL https://github.com/dokku/smoke-test-app/releases/download/2.0.0/smoke-

 ### Initializing an app repository from a remote image without a registry

+> [!IMPORTANT]
 > New as of 0.30.0

 A Dokku app repository can be initialized or updated from the contents of an image archive tar file  via the `git:load-image` command. This method can be used when a Docker Registry is unavailable to act as an intermediary for storing an image, such as when building an image in CI and deploying directly from that image.
@@ -245,6 +252,7 @@ See the [dockerfile documentation](/docs/deployment/builders/dockerfiles.md) to

 ### Initializing an app repository from a remote repository

+> [!IMPORTANT]
 > New as of 0.23.0

 A Dokku app repository can be initialized or updated from a remote git repository via the `git:sync` command. This command will either clone or fetch updates from a remote repository and has undefined behavior if the history cannot be fast-fowarded to the referenced repository reference. Any repository that can be cloned by the `dokku` user can be specified.
@@ -276,6 +284,7 @@ dokku git:sync --build node-js-app https://github.com/heroku/node-js-getting-sta

 ### Initializing from private repositories

+> [!IMPORTANT]
 > New as of 0.24.0

 Initializing from a private repository requires one of the following:
--- a/docs/deployment/remote-commands.md
+++ b/docs/deployment/remote-commands.md
@@ -91,7 +91,7 @@ In addition, the following commands have special local side-effects:

 #### Specifying a remote

-While many users will only ever push to a single dokku remote from a given repository, it may be useful to point the same repository at multiple remotes, especially in the case of pre-production environments. This can be done via the `remote` commands. These commands are _only_ available within the official remote client, and are not server-side commands.
+While many users will only ever push to a single dokku remote from a given repository, it may be useful to point the same repository at multiple remotes, especially in the case of pre-production environments. This can be done via the `remote` commands. These commands are *only* available within the official remote client, and are not server-side commands.

 To see your currently configured remote, run `dokku remote`. This will respect the `--remote` flag.

@@ -101,7 +101,7 @@ To add a remote, run `dokku remote:add $REMOTE_NAME dokku@dokku.me:$APP_NAME`, r

 To remove a remote, run `dokku remote:remove $REMOTE_NAME`. This is equivalent to running `git remote remove $REMOTE_NAME`.

-By default, the remote in use is `dokku`. To change the remote the client uses by default, run `dokku remote:set $REMOTE_NAME`, where `$REMOTE_NAME` is the name of your desired remote. This will not check the value specified, so that remote _must_ be available or errors will occur when running normal client commands. Note that specifying `--remote` when running dokku commands will override this configuration value.
+By default, the remote in use is `dokku`. To change the remote the client uses by default, run `dokku remote:set $REMOTE_NAME`, where `$REMOTE_NAME` is the name of your desired remote. This will not check the value specified, so that remote *must* be available or errors will occur when running normal client commands. Note that specifying `--remote` when running dokku commands will override this configuration value.

 To clear the configured remote, run `dokku remote:unset`. The client will unset the configured remote, and will default back to `dokku`, or the value of `--remote` if specified.

--- a/docs/deployment/schedulers/docker-local.md
+++ b/docs/deployment/schedulers/docker-local.md
@@ -1,5 +1,6 @@
 # Docker Local Scheduler

+> [!IMPORTANT]
 > Subcommands new as of 0.12.12

 ```
@@ -7,6 +8,7 @@ scheduler-docker-local:report [<app>] [<flag>]              # Displays a schedul
 scheduler-docker-local:set <app> <key> (<value>)            # Set or clear a scheduler-docker-local property for an app
 ```

+> [!IMPORTANT]
 > New as of 0.12.0

 Dokku natively includes functionality to manage application lifecycles for a single server using the `scheduler-docker-local` plugin. It is the default scheduler, but as with all schedulers, it is set on a per-application basis. The scheduler can currently be overridden by running the following command:
@@ -55,6 +57,7 @@ All image containers with the label `org.opencontainers.image.vendor=linuxserver

 ### Deploying Process Types in Parallel

+> [!IMPORTANT]
 > New as of 0.25.5

 By default, Dokku deploys an app's processes one-by-one in order, with the `web` process being deployed first. Deployment parallelism may be achieved by setting the `parallel-schedule-count` property, which defaults to `1`. Increasing this number increases the number of process types that may be deployed in parallel (with the web process being the exception).
@@ -78,6 +81,7 @@ Note that increasing the value of `parallel-schedule-count` may significantly im

 #### Increasing parallelism within a process deploy

+> [!IMPORTANT]
 > New as of 0.26.0

 By default, Dokku will deploy one instance of a given process type at a time. This can be increased by customizing the `app.json` `formation` key to include a `max_parallel` key for the given process type.
@@ -121,7 +125,6 @@ This plugin implements various functionality through `plugn` triggers to integra
 - `ps:stop`
 - `run`

-
 ### Logging support

 App logs for the `logs` command are fetched from running containers via the `docker` cli. To persist logs across deployments, consider using Dokku's [vector integration](/docs/deployment/logs.md#vector-logging-shipping) to ship logs to another service or a third-party platform.
@@ -133,15 +136,15 @@ The `docker-local` scheduler supports a minimal list of resource _limits_ and _r
 #### Resource Limits

 - cpu: (docker option: `--cpus`), is specified in number of CPUs a process can access.
-  - See the ["CPU" section](https://docs.docker.com/config/containers/resource_constraints/#cpu) of the Docker Runtime Options documentation for more information.
+    - See the ["CPU" section](https://docs.docker.com/config/containers/resource_constraints/#cpu) of the Docker Runtime Options documentation for more information.
 - memory: (docker option: `--memory`) should be specified with a suffix of `b` (bytes), `k` (kilobytes), `m` (megabytes), `g` (gigabytes). Default unit is `m` (megabytes).
-  - See the ["Memory" section](https://docs.docker.com/config/containers/resource_constraints/#memory) of the Docker Runtime Options documentation for more information.
+    - See the ["Memory" section](https://docs.docker.com/config/containers/resource_constraints/#memory) of the Docker Runtime Options documentation for more information.
 - memory-swap: (docker option: `--memory-swap`) should be specified with a suffix of `b` (bytes), `k` (kilobytes), `m` (megabytes), `g` (gigabytes)
-  - See the ["Memory" section](https://docs.docker.com/config/containers/resource_constraints/#memory) of the Docker Runtime Options documentation for more information.
+    - See the ["Memory" section](https://docs.docker.com/config/containers/resource_constraints/#memory) of the Docker Runtime Options documentation for more information.
 - nvidia-gpus: (docker option: `--gpus`), is specified in number of Nvidia GPUs a process can access.
-  - See the ["GPU" section](https://docs.docker.com/config/containers/resource_constraints/#gpu) of the Docker Runtime Options documentation for more information.
+    - See the ["GPU" section](https://docs.docker.com/config/containers/resource_constraints/#gpu) of the Docker Runtime Options documentation for more information.

 #### Resource Reservations

 - memory: (docker option: `--memory-reservation`) should be specified with a suffix of `b` (bytes), `k` (kilobytes), `m` (megabytes), `g` (gigabytes). Default unit is `m` (megabytes).
-  - See the ["Memory" section](https://docs.docker.com/config/containers/resource_constraints/#memory) of the Docker Runtime Options documentation for more information.
+    - See the ["Memory" section](https://docs.docker.com/config/containers/resource_constraints/#memory) of the Docker Runtime Options documentation for more information.
--- a/docs/deployment/schedulers/kubernetes.md
+++ b/docs/deployment/schedulers/kubernetes.md
@@ -1,6 +1,7 @@
 # Kubernetes Scheduler

-> Warning: This scheduler is not in Dokku core and thus functionality may change over time as the API stabilizes.
+> [!WARNING]
+> This scheduler is not in Dokku core and thus functionality may change over time as the API stabilizes.

 The [Kubernetes Scheduler Plugin](https://github.com/dokku/dokku-scheduler-kubernetes) is available free as an external plugin. Please see the plugin's [issue tracker](https://github.com/dokku/dokku-scheduler-kubernetes/issues) for more information on the status of the plugin.

--- a/docs/deployment/schedulers/nomad.md
+++ b/docs/deployment/schedulers/nomad.md
@@ -1,6 +1,7 @@
 # Nomad Scheduler

-> Warning: This scheduler is not in Dokku core and thus functionality may change over time as the API stabilizes.
+> [!WARNING]
+> This scheduler is not in Dokku core and thus functionality may change over time as the API stabilizes.

 The [Nomad Scheduler Plugin](https://github.com/dokku/dokku-scheduler-nomad) is available free as an external plugin. Please see the plugin's [issue tracker](https://github.com/dokku/dokku-scheduler-nomad/issues) for more information on the status of the plugin.

@@ -20,4 +21,5 @@ This plugin implements various functionality through `plugn` triggers to integra

 ### Logging support

-> Warning: Fetching app logs for the `logs` command is currently not implemented. Please consider using [Vector](https://vector.dev/docs/setup/installation/platforms/kubernetes/) or a similar tool to ship logs to another service or a third-party platform.
+> [!WARNING]
+> Fetching app logs for the `logs` command is currently not implemented. Please consider using [Vector](https://vector.dev/docs/setup/installation/platforms/kubernetes/) or a similar tool to ship logs to another service or a third-party platform.
--- a/docs/deployment/schedulers/null.md
+++ b/docs/deployment/schedulers/null.md
@@ -1,5 +1,6 @@
 # Null Scheduler

+> [!IMPORTANT]
 > New as of 0.25.0

 The `null` scheduler does nothing, and is useful for routing to services not managed by Dokku. It should not be used in normal operation. Please see the [network documentation](/docs/networking/network.md#routing-an-app-to-a-known-ip:port-combination) for more information on the aforementioned use case.
--- a/docs/deployment/schedulers/scheduler-management.md
+++ b/docs/deployment/schedulers/scheduler-management.md
@@ -1,5 +1,6 @@
 # Scheduler Management

+> [!IMPORTANT]
 > New as of 0.26.0

 ```
@@ -91,23 +92,23 @@ Custom plugins names _must_ have the prefix `scheduler-` or scheduler overriding
 At this time, the following dokku commands are used to implement a complete scheduler.

 - `apps:destroy`: stops the app processes on the scheduler
-  - triggers: post-delete, scheduler-register-retired, scheduler-retire
+    - triggers: post-delete, scheduler-register-retired, scheduler-retire
 - `apps:rename`: handles app renaming
-  - triggers: post-app-rename-setup
+    - triggers: post-app-rename-setup
 - `apps:clone`: handles app cloning
-  - triggers: post-app-clone-setup
+    - triggers: post-app-clone-setup
 - `deploy`: deploys app proceses and checks the status of a deploy
-  - triggers: scheduler-app-status, scheduler-deploy, scheduler-is-deployed, scheduler-logs-failed
+    - triggers: scheduler-app-status, scheduler-deploy, scheduler-is-deployed, scheduler-logs-failed
 - `enter`: enters a running container
-  - triggers: scheduler-enter
+    - triggers: scheduler-enter
 - `logs`: fetches app logs
-  - triggers: scheduler-logs
+    - triggers: scheduler-logs
 - `run`: starts one-off run containers (detached and non-detached) as well as listing run processes
-  - triggers: scheduler-run, scheduler-run-list
+    - triggers: scheduler-run, scheduler-run-list
 - `ps:stop`: stops app processes
-  - triggers: scheduler-stop
+    - triggers: scheduler-stop
 - `ps:inspect`: outputs inspect output for processes in an app
-  - triggers: scheduler-inspect
+    - triggers: scheduler-inspect

 Schedulers may decide to omit some functionality here, or use plugin triggers to supplement config with information from other plugins. Additionally, a scheduler may implement other triggers in order handle any extra processes needed during a deploy.

--- a/docs/deployment/user-management.md
+++ b/docs/deployment/user-management.md
@@ -1,5 +1,6 @@
 # User Management

+> [!IMPORTANT]
 > New as of 0.7.0

 ```
@@ -34,6 +35,7 @@ The output contains the following information:
 - The `KEY_NAME`.
 - A comma separated list of SSH options under the `SSHCOMMAND_ALLOWED_KEYS` name.

+> [!IMPORTANT]
 > New as of 0.20.2

 The keys for a specific user may be listed by specifying a second argument to the `ssh-keys:list` command:
@@ -42,6 +44,7 @@ The keys for a specific user may be listed by specifying a second argument to th
 dokku ssh-keys:list admin
 ```

+> [!IMPORTANT]
 > New as of 0.22.3

 The output format may be specified via the `--format` flag. Supported values include `json` and `text`.
@@ -82,7 +85,6 @@ echo "$CONTENTS_OF_YOUR_PUBLIC_SSH_KEY_HERE" | dokku ssh-keys:add KEY_NAME
 SHA256:ABC123ABC123+abc123abc123Zabc123abcZ123abc
 ```

-
 ```shell
 cat path/to/id_rsa.pub | dokku ssh-keys:add KEY_NAME
 ```
@@ -91,7 +93,6 @@ cat path/to/id_rsa.pub | dokku ssh-keys:add KEY_NAME
 SHA256:ABC123ABC123+abc123abc123Zabc123abcZ123abc
 ```

-
 Admin users and root can add keys remotely by specifying the `dokku` bin on their `ssh` command:

 ```shell
--- a/docs/deployment/zero-downtime-deploys.md
+++ b/docs/deployment/zero-downtime-deploys.md
@@ -1,5 +1,6 @@
 # Zero Downtime Deploy Checks

+> [!IMPORTANT]
 > New as of 0.5.0

 ```
@@ -83,6 +84,7 @@ dokku checks:disable node-js-app worker

 ### Displaying checks reports for an app

+> [!IMPORTANT]
 > New as of 0.8.1

 You can get a report about the app's checks status using the `checks:report` command:
@@ -135,6 +137,7 @@ dokku checks:report node-js-app --checks-disabled-list

 ## Customizing checks

+> [!IMPORTANT]
 > New as of 0.31.0

 If your application needs a longer period to boot up - perhaps to load data into memory, or because of slow boot time - you may also use Dokku's `checks` functionality to more precisely check whether an application can serve traffic or not.
@@ -163,15 +166,16 @@ A healthcheck entry takes the following properties:
 - `attempts`: (default: `3` seconds) Number of retry attempts to perform on failure.
 - `command`: (default `''` - empty string) Command to execute within container.
 - `content`: (default: `''` - empty string) Content to search in http path check output.
-initialDelay	default: 0, unit: seconds) Number of seconds to wait after a container has started before triggering the healthcheck.
+- `initialDelay`: (default: 0, unit: seconds) Number of seconds to wait after a container has started before triggering the healthcheck.
 - `name`: (default: autogenerated) The name of the healthcheck. If unspecified, it will be autogenerated from the rest of the healthcheck information.
 - `path`: (default: `/` - for http checks): An http path to check.
 - `timeout`: (default: `5` seconds): Number of seconds to wait before timing out a healthcheck.
 - `type`: (default: `""` - none): Type of the healthcheck. Options: liveness, readiness, startup.
- `uptime`: (default: `""` - none): Amount of time the container must be alive before the container is considered healthy. Any restarts will cause this to check to fail, and this check does not respect retries.	
+- `uptime`: (default: `""` - none): Amount of time the container must be alive before the container is considered healthy. Any restarts will cause this to check to fail, and this check does not respect retries.
 - `wait`: (default: `5` seconds): Number of seconds to wait between healthcheck attempts.

-> Warning: Healthchecks are implemented by specific scheduler plugins, and not all plugins support all options. Please consult the scheduler documentation for further details on what is supported.
+> [!WARNING]
+> Healthchecks are implemented by specific scheduler plugins, and not all plugins support all options. Please consult the scheduler documentation for further details on what is supported.

 See the [docker-container-healthchecker](https://github.com/dokku/docker-container-healthchecker) documentation for more details on how healthchecks are interpreted.

--- a/docs/development/plugin-creation.md
+++ b/docs/development/plugin-creation.md
@@ -145,6 +145,7 @@ Any functions that must be kept private should reside in the plugin's `trigger/`

 ### Use helper functions to fetch app images

+> [!IMPORTANT]
 > New as of 0.4.0

 Dokku allows image tagging and deployment of tagged images. This means hard-coding the `$IMAGE` as `dokku/$APP` is no longer sufficient.
@@ -155,6 +156,7 @@ Plugins should use `get_running_image_tag()` and `get_app_image_name()` as sourc

 ### Use `$DOCKER_BIN` instead of `docker` directly

+> [!IMPORTANT]
 > New as of 0.17.5

 Certain systems may require a wrapper function around the `docker` binary for proper execution. Utilizing the `$DOCKER_BIN` environment variable when calling docker for those functions is preferred.
@@ -169,6 +171,7 @@ docker run -d $IMAGE /bin/bash -e -c "$COMMAND"

 ### Include labels for all temporary containers and images

+> [!IMPORTANT]
 > New as of 0.5.0

 As of 0.5.0, labels are used to help cleanup intermediate containers with `dokku cleanup`. Plugins that create containers and images should add the correct labels to the `build`, `commit`, and `run` docker commands.
@@ -197,7 +200,7 @@ Avoid copying files from running containers as these files may change over time.
 source "$PLUGIN_CORE_AVAILABLE_PATH/common/functions"

 local TMP_FILE=$(mktemp "/tmp/dokku-${DOKKU_PID}-${FUNCNAME[0]}.XXXXXX")
-trap "rm -rf '$TMP_FILE' >/dev/null" RETURN INT TERM
+trap "rm -rf '$TMP_FILE' >/dev/null" RETURN INT TERM EXIT

 local IMAGE_TAG="$(get_running_image_tag "$APP")"
 local IMAGE=$(get_deploying_app_image_name "$APP" "$IMAGE_TAG")
@@ -208,6 +211,7 @@ Files are copied from the `/app` directory - for images built via buildpacks - o

 ### Avoid calling the `dokku` binary directly

+> [!IMPORTANT]
 > New as of 0.6.0

 Plugins should **not** call the `dokku` binary directly from within plugins because clients using the `--app` argument are potentially broken when doing so.
--- a/docs/development/plugin-triggers.md
+++ b/docs/development/plugin-triggers.md
@@ -252,6 +252,21 @@ APP="$1"; PROPERTY="$2"
 # TODO
 ```

+### `builder-herokuish-allowed`
+
+- Description: Checks if herokuish is allowed to run on non-amd64 hosts
+- Invoked by: unit tests
+- Arguments: `$APP`
+- Example:
+
+```shell
+#!/usr/bin/env bash
+
+set -eo pipefail; [[ $DOKKU_TRACE ]] && set -x
+
+# TODO
+```
+
 ### `builder-image-is-cnb`

 - Description: Checks if an image is cnb-based
@@ -297,6 +312,36 @@ set -eo pipefail; [[ $DOKKU_TRACE ]] && set -x
 # TODO
 ```

+### `buildpack-stack-name`
+
+- Description: Retrieves the configured buildpack stack for the pack and herokuish builders
+- Invoked by: builder-herokuish and builder-pack
+- Arguments: `$APP`
+- Example:
+
+```shell
+#!/usr/bin/env bash
+
+set -eo pipefail; [[ $DOKKU_TRACE ]] && set -x
+
+# TODO
+```
+
+### `caddy-template-source`
+
+- Description: Retrieves an alternative template for the caddy compose config
+- Invoked by: caddy-vhosts
+- Arguments: `$APP`
+- Example:
+
+```shell
+#!/usr/bin/env bash
+
+set -eo pipefail; [[ $DOKKU_TRACE ]] && set -x
+
+# TODO
+```
+
 ### `certs-exists`

 - Description: Echos `true` if certs exists for the app, `false` otherwise
@@ -646,7 +691,8 @@ set -eo pipefail; [[ $DOKKU_TRACE ]] && set -x

 ### `docker-args-build`

-> Warning: Deprecated, please use `docker-args-process-build` instead
+> [!WARNING]
+> Deprecated, please use `docker-args-process-build` instead

 - Description:
 - Invoked by: `internal function dokku_build() (build phase)`
@@ -671,7 +717,8 @@ echo -n "$STDIN$output"

 ### `docker-args-deploy`

-> Warning: Deprecated, please use `docker-args-process-deploy` instead
+> [!WARNING]
+> Deprecated, please use `docker-args-process-deploy` instead

 - Description:
 - Invoked by: `dokku deploy`
@@ -742,7 +789,8 @@ APP="$1"; IMAGE_SOURCE_TYPE="$3"; IMAGE_TAG="$2"; IMAGE=$(get_app_image_name $AP

 ### `docker-args-run`

-> Warning: Deprecated, please use `docker-args-process-run` instead
+> [!WARNING]
+> Deprecated, please use `docker-args-process-run` instead

 - Description:
 - Invoked by: `dokku run`
@@ -969,7 +1017,8 @@ set -eo pipefail; [[ $DOKKU_TRACE ]] && set -x
 # TODO
 ```

-> Warning: The `git-pre-pull` trigger should _not_ be used for authentication since it does not get called for commands that use `git-upload-archive` such as `git archive`. Instead, use the [`user-auth`](#user-auth) trigger.
+> [!WARNING]
+> The `git-pre-pull` trigger should _not_ be used for authentication since it does not get called for commands that use `git-upload-archive` such as `git archive`. Instead, use the [`user-auth`](#user-auth) trigger.

 ### `git-revision`

@@ -1005,6 +1054,21 @@ if [[ ! -f  "$DOKKU_ROOT/VHOST" ]]; then
 fi
 ```

+### `haproxy-template-source`
+
+- Description: Retrieves an alternative template for the haproxy compose config
+- Invoked by: haproxy-vhosts
+- Arguments: `$APP`
+- Example:
+
+```shell
+#!/usr/bin/env bash
+
+set -eo pipefail; [[ $DOKKU_TRACE ]] && set -x
+
+# TODO
+```
+
 ### `logs-get-property`

 - Description: Return the value for an app's log property
@@ -1161,7 +1225,7 @@ set -eo pipefail; [[ $DOKKU_TRACE ]] && set -x
 - Description: Return the path to a `sigil` template that should be used to generate a given nginx configuration file.
 - Invoked by: `nginx-vhosts#build-config`
 - Arguments: `$APP $TEMPLATE_TYPE`
-  - The `TEMPLATE_TYPE` argument can be one of: `[app-config, hsts-config, validate-config]`
+    - The `TEMPLATE_TYPE` argument can be one of: `[app-config, hsts-config, validate-config]`
 - Example:

 ```shell
@@ -1224,7 +1288,8 @@ echo "$NEW_SUBDOMAIN.$VHOST"

 ### `nginx-pre-reload`

-> Warning: The arguments INTERNAL_PORT and INTERNAL_IP_ADDRESS are no longer sufficient to retrieve all app listeners. Please run `plugn trigger network-get-listeners APP` within any implementation of `nginx-pre-reload` in order to retrieve all application listeners.
+> [!WARNING]
+> The arguments INTERNAL_PORT and INTERNAL_IP_ADDRESS are no longer sufficient to retrieve all app listeners. Please run `plugn trigger network-get-listeners APP` within any implementation of `nginx-pre-reload` in order to retrieve all application listeners.

 - Description: Run before nginx reloads hosts
 - Invoked by: `dokku proxy:build-config`
@@ -1241,6 +1306,21 @@ set -eo pipefail; [[ $DOKKU_TRACE ]] && set -x
 nginx -t
 ```

+### `openresty-template-source`
+
+- Description: Retrieves an alternative template for the openresty compose config
+- Invoked by: openresty-vhosts
+- Arguments: `$APP`
+- Example:
+
+```shell
+#!/usr/bin/env bash
+
+set -eo pipefail; [[ $DOKKU_TRACE ]] && set -x
+
+# TODO
+```
+
 ### `ports-clear`

 - Description: Clears the ports for a given app without triggering further restarts or rebuilds
@@ -1410,7 +1490,8 @@ set -eo pipefail; [[ $DOKKU_TRACE ]] && set -x

 ### `post-build-pack`

-> Warning: The pack plugin trigger apis are under development and may change
+> [!WARNING]
+> The pack plugin trigger apis are under development and may change
 > between minor releases until the 1.0 release.

 - Description: Allows you to run commands after the build image is create for a given app. Only applies to apps using pack.
@@ -1441,6 +1522,21 @@ set -eo pipefail; [[ $DOKKU_TRACE ]] && set -x
 # TODO
 ```

+### `post-build-lambda`
+
+- Description: Allows you to run commands after the build image is create for a given app. Only applies to apps using lambda.
+- Invoked by: `internal function dokku_build() (build phase)`
+- Arguments: `$APP` `$SOURCECODE_WORK_DIR`
+- Example:
+
+```shell
+#!/usr/bin/env bash
+
+set -eo pipefail; [[ $DOKKU_TRACE ]] && set -x
+
+# TODO
+```
+
 ### `post-certs-remove`

 - Description: Allows you to run commands after a cert is removed
@@ -1477,7 +1573,7 @@ APP="$1"

 ### `post-config-update`

- Description: Allows you to get notified when one or more configs is added or removed. Action can be `set` or `unset`. 
+- Description: Allows you to get notified when one or more configs is added or removed. Action can be `set` or `unset`.
 - Invoked by: `dokku config:set`, `dokku config:unset`
 - Arguments: `$APP` `set|unset` `key1=VALUE1 key2=VALUE2`
 - Example:
@@ -1624,7 +1720,8 @@ haproxy-build-config "$APP"

 ### `post-release-builder`

-> Warning: Image mutation in this trigger may result in an invalid run state, and is heavily discouraged.
+> [!WARNING]
+> Image mutation in this trigger may result in an invalid run state, and is heavily discouraged.

 - Description: Invokes a command after the build process is complete.
 - Invoked by: builder plugins
@@ -1641,6 +1738,21 @@ BUILDER_TYPE="$1"; APP="$2"; IMAGE=$3
 # TODO
 ```

+### `post-stack-set` TODO
+
+- Description: Allows you to run commands after changing the stack
+- Invoked by: buildpacks plugin
+- Arguments: `$APP` `$VALUE`
+- Example:
+
+```shell
+#!/usr/bin/env bash
+
+set -eo pipefail; [[ $DOKKU_TRACE ]] && set -x
+
+# TODO
+```
+
 ### `post-stop`

 - Description: Can be used to run commands after an app is manually stopped
@@ -1674,9 +1786,25 @@ set -eo pipefail; [[ $DOKKU_TRACE ]] && set -x
 # TODO
 ```

+### `pre-build-lambda`
+
+- Description: Allows you to run commands before the build image is created for a given app. For instance, this can be useful to add env vars to your container. Only applies to apps using lambda.
+- Invoked by: `internal function dokku_build() (build phase)`
+- Arguments: `$APP` `$SOURCECODE_WORK_DIR`
+- Example:
+
+```shell
+#!/usr/bin/env bash
+
+set -eo pipefail; [[ $DOKKU_TRACE ]] && set -x
+
+# TODO
+```
+
 ### `pre-build-pack`

-> Warning: The pack plugin trigger apis are under development and may change
+> [!WARNING]
+> The pack plugin trigger apis are under development and may change
 > between minor releases until the 1.0 release.

 - Description: Allows you to run commands before the build image is created for a given app. For instance, this can be useful to add env vars to your container. Only applies to apps using pack.
@@ -1830,9 +1958,27 @@ DOCKER_COMMIT_LABEL_ARGS=("--change" "LABEL org.label-schema.schema-version=1.0"
 docker commit "${DOCKER_COMMIT_LABEL_ARGS[@]}" $CID $IMAGE >/dev/null
 ```

+### `pre-release-lambda`
+
+- Description: Allows you to run commands before environment variables are set for the release step of the deploy. Only applies to apps using lambda.
+- Invoked by: `internal function dokku_release() (release phase)`
+- Arguments: `$APP $IMAGE_TAG`
+- Example:
+
+```shell
+#!/usr/bin/env bash
+
+set -eo pipefail; [[ $DOKKU_TRACE ]] && set -x
+source "$PLUGIN_CORE_AVAILABLE_PATH/common/functions"
+APP="$1"; IMAGE_TAG="$2";
+
+# TODO
+```
+
 ### `pre-release-pack`

-> Warning: The pack plugin trigger apis are under development and may change
+> [!WARNING]
+> The pack plugin trigger apis are under development and may change
 > between minor releases until the 1.0 release.

 - Description: Allows you to run commands before environment variables are set for the release step of the deploy. Only applies to apps using pack.
@@ -1963,7 +2109,8 @@ set -eo pipefail; [[ $DOKKU_TRACE ]] && set -x

 ### `proxy-configure-ports`

-> Warning: Deprecated, please use `ports-configure` instead
+> [!WARNING]
+> Deprecated, please use `ports-configure` instead

 - Description: Configures the port mapping
 - Invoked by: `internally triggered by proxy plugins`
@@ -2052,6 +2199,7 @@ set -eo pipefail; [[ $DOKKU_TRACE ]] && set -x

 # TODO
 ```
+
 ### `ps-current-scale`

 - Description: Prints out the current scale contents (process-type=quantity) delimited by newlines.
@@ -2191,7 +2339,8 @@ mail -s "$APP containers on $HOSTNAME failed to retire" ops@dokku.me

 ### `scheduler-app-status`

-> Warning: The scheduler plugin trigger apis are under development and may change
+> [!WARNING]
+> The scheduler plugin trigger apis are under development and may change
 > between minor releases until the 1.0 release.

 - Description: Fetch the status of an app
@@ -2210,7 +2359,8 @@ DOKKU_SCHEDULER="$1"; APP="$2";

 ### `scheduler-deploy`

-> Warning: The scheduler plugin trigger apis are under development and may change
+> [!WARNING]
+> The scheduler plugin trigger apis are under development and may change
 > between minor releases until the 1.0 release.

 - Description: Allows you to run scheduler commands when an app is deployed
@@ -2229,7 +2379,8 @@ DOKKU_SCHEDULER="$1"; APP="$2"; IMAGE_TAG="$3";

 ### `scheduler-detect`

-> Warning: The scheduler plugin trigger apis are under development and may change
+> [!WARNING]
+> The scheduler plugin trigger apis are under development and may change
 > between minor releases until the 1.0 release.

 - Description: Allows you to check which scheduler is in use for an app
@@ -2248,7 +2399,8 @@ APP="$1"

 ### `scheduler-enter`

-> Warning: The scheduler plugin trigger apis are under development and may change
+> [!WARNING]
+> The scheduler plugin trigger apis are under development and may change
 > between minor releases until the 1.0 release.

 - Description: Allows you to enter a running container for a given app
@@ -2267,7 +2419,8 @@ DOKKU_SCHEDULER="$1"; APP="$2"; ARGS="$@"

 ### `scheduler-inspect`

-> Warning: The scheduler plugin trigger apis are under development and may change
+> [!WARNING]
+> The scheduler plugin trigger apis are under development and may change
 > between minor releases until the 1.0 release.

 - Description: Allows you to run inspect commands for all containers for a given app
@@ -2284,11 +2437,31 @@ DOKKU_SCHEDULER="$1"; APP="$2";
 # TODO
 ```

-### `scheduler-logs`
+### `scheduler-is-deployed`

 > Warning: The scheduler plugin trigger apis are under development and may change
 > between minor releases until the 1.0 release.

+- Description: Allows you to check if the scheduler has deployed the app
+- Invoked by: Various plugins
+- Arguments: `$DOKKU_SCHEDULER $APP`
+- Example:
+
+```shell
+#!/usr/bin/env bash
+
+set -eo pipefail; [[ $DOKKU_TRACE ]] && set -x
+DOKKU_SCHEDULER="$1"; APP="$2";
+
+# TODO
+```
+
+### `scheduler-logs`
+
+> [!WARNING]
+> The scheduler plugin trigger apis are under development and may change
+> between minor releases until the 1.0 release.
+
 - Description: Allows you to run scheduler commands when retrieving container logs
 - Invoked by: `dokku logs:failed`
 - Arguments: `$DOKKU_SCHEDULER $APP $PROCESS_TYPE $TAIL $PRETTY_PRINT $NUM`
@@ -2305,7 +2478,8 @@ DOKKU_SCHEDULER="$1"; APP="$2"; PROCESS_TYPE="$3"; TAIL="$4"; PRETTY_PRINT="$5";

 ### `scheduler-logs-failed`

-> Warning: The scheduler plugin trigger apis are under development and may change
+> [!WARNING]
+> The scheduler plugin trigger apis are under development and may change
 > between minor releases until the 1.0 release.

 - Description: Allows you to run scheduler commands when retrieving failed container logs
@@ -2324,7 +2498,8 @@ DOKKU_SCHEDULER="$1"; APP="$2";

 ### `scheduler-pre-restore`

-> Warning: The scheduler plugin trigger apis are under development and may change
+> [!WARNING]
+> The scheduler plugin trigger apis are under development and may change
 > between minor releases until the 1.0 release.

 - Description: Allows you to run commands before an app is restored
@@ -2343,7 +2518,8 @@ DOKKU_SCHEDULER="$1"; APP="$2";

 ### `scheduler-post-delete`

-> Warning: The scheduler plugin trigger apis are under development and may change
+> [!WARNING]
+> The scheduler plugin trigger apis are under development and may change
 > between minor releases until the 1.0 release.

 - Description: Allows you to run scheduler commands when an app is deleted
@@ -2360,11 +2536,31 @@ DOKKU_SCHEDULER="$1"; APP="$2"; IMAGE_TAG="$3";
 # TODO
 ```

-### `scheduler-post-run`
+### `scheduler-post-deploy-process`

 > Warning: The scheduler plugin trigger apis are under development and may change
 > between minor releases until the 1.0 release.

+- Description: Allows you to run a command after a process has been started
+- Invoked by: scheduler-docker-local
+- Arguments: `$APP $PROCESS_TYPE`
+- Example:
+
+```shell
+#!/usr/bin/env bash
+
+set -eo pipefail; [[ $DOKKU_TRACE ]] && set -x
+APP="$1"; PROCESS_TYPE="$2";
+
+# TODO
+```
+
+### `scheduler-post-run`
+
+> [!WARNING]
+> The scheduler plugin trigger apis are under development and may change
+> between minor releases until the 1.0 release.
+
 - Description: Allows you to run scheduler commands after a `dokku run` invocation is called
 - Invoked by: `dokku run`
 - Arguments: `$DOKKU_SCHEDULER $APP $CONTAINER_ID`
@@ -2381,7 +2577,8 @@ DOKKU_SCHEDULER="$1"; APP="$2"; CONTAINER_ID="$3";

 ### `scheduler-register-retired`

-> Warning: The scheduler plugin trigger apis are under development and may change
+> [!WARNING]
+> The scheduler plugin trigger apis are under development and may change
 > between minor releases until the 1.0 release.

 - Description: Allows scheduling retiring a local container and any related images
@@ -2401,7 +2598,8 @@ CONTAINER_ID="$2";

 ### `scheduler-retire`

-> Warning: The scheduler plugin trigger apis are under development and may change
+> [!WARNING]
+> The scheduler plugin trigger apis are under development and may change
 > between minor releases until the 1.0 release.

 - Description: Allows you to run scheduler commands when containers should be force retired from the system
@@ -2420,7 +2618,8 @@ DOKKU_SCHEDULER="$1"; APP="$2";

 ### `scheduler-run`

-> Warning: The scheduler plugin trigger apis are under development and may change
+> [!WARNING]
+> The scheduler plugin trigger apis are under development and may change
 > between minor releases until the 1.0 release.

 - Description: Allows you to run scheduler commands when a command is executed for your app
@@ -2439,7 +2638,8 @@ DOKKU_SCHEDULER="$1"; APP="$2"; ARGS="${@:3}";

 ### `scheduler-run-list`

-> Warning: The scheduler plugin trigger apis are under development and may change
+> [!WARNING]
+> The scheduler plugin trigger apis are under development and may change
 > between minor releases until the 1.0 release.

 - Description: Lists all run containers for a given app
@@ -2458,7 +2658,8 @@ DOKKU_SCHEDULER="$1"; APP="$2"; FORMAT="$3";

 ### `scheduler-run-logs`

-> Warning: The scheduler plugin trigger apis are under development and may change
+> [!WARNING]
+> The scheduler plugin trigger apis are under development and may change
 > between minor releases until the 1.0 release.

 - Description: Allows you to run scheduler commands when retrieving one-off container logs
@@ -2475,11 +2676,31 @@ DOKKU_SCHEDULER="$1"; APP="$2"; CONTAINER="$3"; TAIL="$4"; PRETTY_PRINT="$5"; NU
 # TODO
 ```

-### `scheduler-stop`
+### `scheduler-run-stop`

 > Warning: The scheduler plugin trigger apis are under development and may change
 > between minor releases until the 1.0 release.

+- Description: Allows a scheduler to stop all "run" containers or a specified container
+- Invoked by: `dokku run:stop`
+- Arguments: `$DOKKU_SCHEDULER $APP $CONTAINER_NAME`
+- Example:
+
+```shell
+#!/usr/bin/env bash
+
+set -eo pipefail; [[ $DOKKU_TRACE ]] && set -x
+DOKKU_SCHEDULER="$1"; APP="$2"; CONTAINER_NAME="$3";
+
+# TODO
+```
+
+### `scheduler-stop`
+
+> [!WARNING]
+> The scheduler plugin trigger apis are under development and may change
+> between minor releases until the 1.0 release.
+
 - Description: Allows you to run scheduler commands when a tag is destroyed
 - Invoked by: `dokku apps:destroy, dokku ps:stop`
 - Arguments: `$DOKKU_SCHEDULER $APP $REMOVE_CONTAINERS`
@@ -2510,6 +2731,21 @@ APP="$1"
 # TODO
 ```

+### `traefik-template-source`
+
+- Description: Retrieves an alternative template for the traefik compose config
+- Invoked by: traefik-vhosts
+- Arguments: `$APP`
+- Example:
+
+```shell
+#!/usr/bin/env bash
+
+set -eo pipefail; [[ $DOKKU_TRACE ]] && set -x
+
+# TODO
+```
+
 ### `uninstall`

 - Description: Used to cleanup after itself.
--- a/docs/development/release-process.md
+++ b/docs/development/release-process.md
@@ -29,7 +29,7 @@ The workflow looks like this:
 ```shell
 # having dokku-arch in ../dokku-arch
 vagrant up build-arch
-# wait for "==> build-arch: ==> Finished making: dokku 0.31.0-2 (Mon Feb 22 23:20:37 CET 2016)"
+# wait for "==> build-arch: ==> Finished making: dokku 0.31.2-2 (Mon Feb 22 23:20:37 CET 2016)"
 cd ../dokku-arch
 git add PKGBUILD .SRCINFO
 git commit -m 'Update to dokku 0.9.9'
--- a/docs/enterprise/pro.md
+++ b/docs/enterprise/pro.md
@@ -29,4 +29,4 @@ Dokku Pro has the following functionality:
 - Authenticated HTTP(S) endpoints for git push functionality
 - Single Page App (SPA) Web UI exposing app, datastore, and ssh key management

-While each release is fairly feature complete, individual features and documentation will expand over time. Feature development follows a monthly release cadence, with individual bug fixes released on an as needed basis. 
+While each release is fairly feature complete, individual features and documentation will expand over time. Feature development follows a monthly release cadence, with individual bug fixes released on an as needed basis.
--- a/docs/getting-started/advanced-installation.md
+++ b/docs/getting-started/advanced-installation.md
@@ -78,7 +78,7 @@ Follow the [user management documentation](/docs/deployment/user-management.md)

 ## VMs with less than 1 GB of memory

-Having less than 1 GB of system memory available for Dokku and its containers may result in unexpected errors, such as `! [remote rejected] master -> master (pre-receive hook declined)` during installation of NPM dependencies (https://github.com/npm/npm/issues/3867).
+Having less than 1 GB of system memory available for Dokku and its containers may result in unexpected errors, such as `! [remote rejected] master -> master (pre-receive hook declined)` [during installation of NPM dependencies](https://github.com/npm/npm/issues/3867).

 To work around this issue, it might suffice to augment the Linux swap file size to a maximum of twice the physical memory size.

--- a/docs/getting-started/install/docker.md
+++ b/docs/getting-started/install/docker.md
@@ -3,7 +3,7 @@
 Pull the dokku/dokku image:

 ```shell
-docker pull dokku/dokku:0.31.0
+docker pull dokku/dokku:0.31.2
 ```

 Next, run the image.
@@ -19,7 +19,7 @@ docker container run \
  --publish 8443:443 \
  --volume /var/lib/dokku:/mnt/dokku \
  --volume /var/run/docker.sock:/var/run/docker.sock \
-  dokku/dokku:0.31.0
+  dokku/dokku:0.31.2
 ```

 The above command will start a new docker container that is ready when a message similar to `Runit started as PID 12345` appears.
@@ -61,7 +61,7 @@ redis: https://github.com/dokku/dokku-redis.git
 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.31.0
+FROM dokku/dokku:0.31.2
 RUN dokku plugin:install https://github.com/dokku/dokku-postgres.git postgres
 RUN dokku plugin:install https://github.com/dokku/dokku-redis.git redis
 ```
--- a/docs/getting-started/install/vagrant.md
+++ b/docs/getting-started/install/vagrant.md
@@ -36,7 +36,7 @@
        Port 22
    ```

-    > For users that have customized the IP address of their VM - either in a custom `Vagrantfile` or via the `DOKKU_IP` environment variable - and are not using `10.0.0.2` for the Vagrant IP, you'll need to instead use the output of `vagrant ssh-config dokku` for your `~/.ssh/config` entry. 
+    > For users that have customized the IP address of their VM - either in a custom `Vagrantfile` or via the `DOKKU_IP` environment variable - and are not using `10.0.0.2` for the Vagrant IP, you'll need to instead use the output of `vagrant ssh-config dokku` for your `~/.ssh/config` entry.

 6. Connect to the server via `vagrant ssh` and add your ssh key to the install. Additionally, set the global domain name to `dokku.me`.

--- a/docs/getting-started/installation/index.md
+++ b/docs/getting-started/installation/index.md
@@ -1,10 +1,10 @@
 # Getting Started with Dokku

-### What is Dokku?
+## What is Dokku?

 Dokku is an extensible, open source Platform as a Service that runs on a single server of your choice. Dokku supports building apps on the fly from a `git push` via either Dockerfile or by auto-detecting the language with Buildpacks, and then starts containers based on your built image. Using technologies such as nginx and cron, Web processes are automatically routed to, while background processes and automated cron tasks are also managed by Dokku.

-### System Requirements
+## System Requirements

 To start using Dokku, you'll need a system that meets the following minimum requirements:

@@ -12,7 +12,7 @@ To start using Dokku, you'll need a system that meets the following minimum requ
    - [Ubuntu 20.04/22.04](https://www.ubuntu.com/download)
    - [Debian 10+ x64](https://www.debian.org/distrib/)
 - A server with one of the following architectures
-    - AMD64 (alternatively known as `x86_64`), commonly used for Intel cloud servers 
+    - AMD64 (alternatively known as `x86_64`), commonly used for Intel cloud servers
    - ARMV7 (alternatively known as `armhf`), commonly used for Raspberry PI
    - ARMV8 (alternatively known as `arm64`), commonly used for Raspberry PI and AWS Graviton

@@ -28,23 +28,23 @@ Finally, we recommend attaching at least one domain name to your server. This is

 Please see the [dns documentation](/docs/networking/dns.md) and [domains documentation](/docs/configuration/domains.md) for more details.

-### Installing the latest stable version
+## Installing the latest stable version

-This is the simple method of installing Dokku. For alternative methods of installation, see the [advanced install guide](/docs/getting-started/advanced-installation.md#configuring). 
+This is the simple method of installing Dokku. For alternative methods of installation, see the [advanced install guide](/docs/getting-started/advanced-installation.md#configuring).

-#### 1. Install Dokku
+### 1. Install Dokku

 To install the latest stable version of Dokku, you can run the following shell commands:

 ```shell
 # for debian systems, installs Dokku via apt-get
-wget -NP . https://dokku.com/install/v0.31.0/bootstrap.sh
-sudo DOKKU_TAG=v0.31.0 bash bootstrap.sh
+wget -NP . https://dokku.com/install/v0.31.2/bootstrap.sh
+sudo DOKKU_TAG=v0.31.2 bash bootstrap.sh
 ```

 The installation process takes about 5-10 minutes, depending upon internet connection speed.

-#### 2. Setup SSH key and Virtualhost Settings
+### 2. Setup SSH key and Virtualhost Settings

 Once the installation is complete, you should configure an ssh key and set your global domain.

@@ -67,6 +67,6 @@ dokku domains:set-global 10.0.0.2.sslip.io

 See the [user management](/docs/deployment/user-management.md#adding-ssh-keys) and [domains documentation](/docs/configuration/domains.md#customizing-hostnames) for more information.

-#### 3. Deploy your first application
+### 3. Deploy your first application

 At this point, you should be able to [deploy to the Dokku installation](/docs/deployment/application-deployment.md).
--- a/docs/getting-started/troubleshooting.md
+++ b/docs/getting-started/troubleshooting.md
@@ -1,5 +1,6 @@
 # Troubleshooting

+> [!IMPORTANT]
 > New as of 0.17.0

 ```
@@ -33,7 +34,7 @@ dokku trace:off

 ## Common Problems

-### I deployed my app but I am getting the default nginx page.
+### I deployed my app but I am getting the default nginx page

 Most of the time it's caused by some defaults newer versions of nginx set. To make sure that's the issue you're having run the following:

@@ -91,7 +92,7 @@ The following error may be emitted from a deploy:

 The `remote rejected` error does not give enough information. Anything could have failed. Enable trace mode and begin debugging. If this does not help you, create a [gist](https://gist.github.com) containing the full log, and create an issue.

-One the reasons why you may get this error is because the command that is run in the container exited (without errors). For example, (in Procfile) when you define a new worker container to run Delayed Job and use the bin/delayed_job start command. This command deamonizes the process and exists. The container thinks it's done so it closes itself. The error you get is the one above. To fix the above problem for Delayed Job, you must define the worker to user rake jobs:work, which doesn't deamonize the process. 
+One the reasons why you may get this error is because the command that is run in the container exited (without errors). For example, (in Procfile) when you define a new worker container to run Delayed Job and use the bin/delayed_job start command. This command deamonizes the process and exists. The container thinks it's done so it closes itself. The error you get is the one above. To fix the above problem for Delayed Job, you must define the worker to user rake jobs:work, which doesn't deamonize the process.

 ### I get the aforementioned error in the build phase (after turning on Dokku tracing)

@@ -121,7 +122,7 @@ Sometimes (especially on DigitalOcean) deploying again seems to get past these s
 resolvconf -u
 ```

-Please see https://github.com/dokku/dokku/issues/841 and https://github.com/dokku/dokku/issues/649.
+Please see [#841](https://github.com/dokku/dokku/issues/841) and [#649](https://github.com/dokku/dokku/issues/649).

 ### After adding an SSH key, I am told I cannot read from the remote repository on push

@@ -155,7 +156,7 @@ Host DOKKU_HOSTNAME

 Also see [issue #116](https://github.com/dokku/dokku/issues/116).

-### I successfully deployed my application with no deployment errors and receiving **Bad Gateway** when attempting to access the application.
+### I successfully deployed my application with no deployment errors and receiving **Bad Gateway** when attempting to access the application

 In many cases the application will require the a `process.env.PORT` port opposed to a specified port.

@@ -171,7 +172,7 @@ Additionally, your application should listen/bind to all interfaces (`0.0.0.0`).

 Please see [#5798](https://github.com/dokku/dokku/issues/5798).

-### Deployment fails because of slow internet connection, messages shows `gzip: stdin: unexpected end of file`.
+### Deployment fails because of slow internet connection, messages shows `gzip: stdin: unexpected end of file`

 If you see output similar this when deploying:

@@ -191,11 +192,11 @@ dokku config:set --global CURL_TIMEOUT=1200
 dokku config:set --global CURL_CONNECT_TIMEOUT=180
 ```

-Please see https://github.com/dokku/dokku/issues/509.
+Please see [#509](https://github.com/dokku/dokku/issues/509).

 Another reason for this error (although it may respond immediately ruling out a timeout issue) may be because you've set the config setting `SSL_CERT_FILE`. Using a config setting with this key interferes with the buildpack's ability to download its dependencies, so you must rename the config setting to something else, e.g. `MY_APP_SSL_CERT_FILE`.

-### Build fails with `Killed` message.
+### Build fails with `Killed` message

 This generally occurs when the server runs out of memory. You can either add more RAM to your server or setup swap space. The follow script will create 2 GB of swap space.

@@ -209,7 +210,7 @@ sudo sysctl -w vm.swappiness=10
 echo vm.swappiness = 10 | sudo tee -a /etc/sysctl.conf
 ```

-### I successfully deployed my application with no deployment errors but I'm receiving Connection Timeout when attempting to access the application.
+### I successfully deployed my application with no deployment errors but I'm receiving Connection Timeout when attempting to access the application

 This can occur if Dokku is running on a system with a firewall like UFW enabled (some OS versions like Ubuntu have this enabled by default). You can check if this is your case by running the following script:

@@ -223,7 +224,7 @@ If the previous script returned `Status: active` and a list of ports, UFW is ena
 sudo ufw disable
 ```

-### I can't connect to my application because the server is sending an invalid response, or can't provide a secure connection.
+### I can't connect to my application because the server is sending an invalid response, or can't provide a secure connection

 This isn't usually an issue with Dokku, but rather an app config problem. This can happen when your application is configured to enforce secure connections/HSTS, but you don't have SSL set up for the app.

--- a/docs/home.html
+++ b/docs/home.html
@@ -10,26 +10,26 @@
    <meta name="author" content="">
    <title>Dokku - The smallest PaaS implementation you've ever seen</title>

-    <link rel="apple-touch-icon" sizes="57x57" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.0/docs/assets/favicons/apple-touch-icon-57x57.png">
-    <link rel="apple-touch-icon" sizes="60x60" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.0/docs/assets/favicons/apple-touch-icon-60x60.png">
-    <link rel="apple-touch-icon" sizes="72x72" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.0/docs/assets/favicons/apple-touch-icon-72x72.png">
-    <link rel="apple-touch-icon" sizes="76x76" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.0/docs/assets/favicons/apple-touch-icon-76x76.png">
-    <link rel="apple-touch-icon" sizes="114x114" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.0/docs/assets/favicons/apple-touch-icon-114x114.png">
-    <link rel="apple-touch-icon" sizes="120x120" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.0/docs/assets/favicons/apple-touch-icon-120x120.png">
-    <link rel="apple-touch-icon" sizes="144x144" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.0/docs/assets/favicons/apple-touch-icon-144x144.png">
-    <link rel="apple-touch-icon" sizes="152x152" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.0/docs/assets/favicons/apple-touch-icon-152x152.png">
-    <link rel="apple-touch-icon" sizes="180x180" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.0/docs/assets/favicons/apple-touch-icon-180x180.png">
-    <link rel="icon" type="image/png" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.0/docs/assets/favicons/favicon-32x32.png" sizes="32x32">
-    <link rel="icon" type="image/png" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.0/docs/assets/favicons/android-chrome-192x192.png" sizes="192x192">
-    <link rel="icon" type="image/png" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.0/docs/assets/favicons/favicon-96x96.png" sizes="96x96">
-    <link rel="icon" type="image/png" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.0/docs/assets/favicons/favicon-16x16.png" sizes="16x16">
-    <link rel="manifest" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.0/docs/assets/favicons/manifest.json">
-    <link rel="shortcut icon" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.0/docs/assets/favicons/favicon.ico">
+    <link rel="apple-touch-icon" sizes="57x57" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.2/docs/assets/favicons/apple-touch-icon-57x57.png">
+    <link rel="apple-touch-icon" sizes="60x60" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.2/docs/assets/favicons/apple-touch-icon-60x60.png">
+    <link rel="apple-touch-icon" sizes="72x72" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.2/docs/assets/favicons/apple-touch-icon-72x72.png">
+    <link rel="apple-touch-icon" sizes="76x76" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.2/docs/assets/favicons/apple-touch-icon-76x76.png">
+    <link rel="apple-touch-icon" sizes="114x114" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.2/docs/assets/favicons/apple-touch-icon-114x114.png">
+    <link rel="apple-touch-icon" sizes="120x120" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.2/docs/assets/favicons/apple-touch-icon-120x120.png">
+    <link rel="apple-touch-icon" sizes="144x144" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.2/docs/assets/favicons/apple-touch-icon-144x144.png">
+    <link rel="apple-touch-icon" sizes="152x152" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.2/docs/assets/favicons/apple-touch-icon-152x152.png">
+    <link rel="apple-touch-icon" sizes="180x180" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.2/docs/assets/favicons/apple-touch-icon-180x180.png">
+    <link rel="icon" type="image/png" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.2/docs/assets/favicons/favicon-32x32.png" sizes="32x32">
+    <link rel="icon" type="image/png" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.2/docs/assets/favicons/android-chrome-192x192.png" sizes="192x192">
+    <link rel="icon" type="image/png" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.2/docs/assets/favicons/favicon-96x96.png" sizes="96x96">
+    <link rel="icon" type="image/png" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.2/docs/assets/favicons/favicon-16x16.png" sizes="16x16">
+    <link rel="manifest" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.2/docs/assets/favicons/manifest.json">
+    <link rel="shortcut icon" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.2/docs/assets/favicons/favicon.ico">
    <meta name="apple-mobile-web-app-title" content="Dokku">
    <meta name="application-name" content="Dokku">
    <meta name="msapplication-TileColor" content="#da532c">
-    <meta name="msapplication-TileImage" content="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.0/docs/assets/favicons/mstile-144x144.png">
-    <meta name="msapplication-config" content="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.0/docs/assets/favicons/browserconfig.xml">
+    <meta name="msapplication-TileImage" content="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.2/docs/assets/favicons/mstile-144x144.png">
+    <meta name="msapplication-config" content="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.2/docs/assets/favicons/browserconfig.xml">
    <meta name="theme-color" content="#ffffff">

    <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.2.0-beta1/dist/css/bootstrap.min.css" rel="stylesheet" integrity="sha384-0evHe/X+R7YkIZDRvuzKMRqM+OrBnVFBL6DOitfPri4tjfHxaWutUpFmBp4vmVor" crossorigin="anonymous">
@@ -38,7 +38,7 @@
    <link rel="preconnect" href="https://fonts.googleapis.com">
    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
    <link href="https://fonts.googleapis.com/css2?family=Lato:wght@400;700;900&display=swap" rel="stylesheet">
-    <link href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.0/docs/assets/style.css" rel="stylesheet">
+    <link href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.2/docs/assets/style.css" rel="stylesheet">
    <!-- <link href="./assets/style.css" rel="stylesheet"> -->
 </head>

@@ -98,7 +98,7 @@
        <main class="container px-4 px-lg-5">
            <div class="row">
                <div class="col-lg-7">
-                    <a class="badge-link" href="https://github.com/dokku/dokku/releases"><span class="badge py-2 d-flex fit-content"><div class="circle align-self-center me-2"></div>Latest release <span id="releaseVersion" class="ms-1">v0.31.0</span></span></a>
+                    <a class="badge-link" href="https://github.com/dokku/dokku/releases"><span class="badge py-2 d-flex fit-content"><div class="circle align-self-center me-2"></div>Latest release <span id="releaseVersion" class="ms-1">v0.31.2</span></span></a>
                    <h1 class="text-white hero-heading mt-5">An open source PAAS alternative to Heroku.</h1>
                    <h4 class="text-white mt-5">Dokku helps you build and manage the lifecycle of applications from building to scaling.</h4>
                    <div class="d-flex mt-5">
@@ -125,7 +125,7 @@
                            </p>
                            <p class="line">
                                <span class="prompt">$</span>
-                                <span class="command">sudo DOKKU_TAG=v0.31.0 bash bootstrap.sh</span>
+                                <span class="command">sudo DOKKU_TAG=v0.31.2 bash bootstrap.sh</span>
                            </p>
                            <br>

@@ -227,7 +227,7 @@
                            Create</a>
                          <a class="nav-link" id="nav-deploy-tab" data-bs-toggle="tab" href="#nav-deploy" role="tab" aria-controls="nav-deploy" aria-selected="false">
                            <svg width="32" height="32" viewBox="0 0 32 32" fill="none" xmlns="http://www.w3.org/2000/svg">
-                                <path d="M29.8709 1.40551C29.8591 1.34642 29.8311 1.29205 29.7903 1.24881C29.7495 1.20556 29.6976 1.17524 29.6407 1.16141C25.8466 0.20375 17.082 3.61605 12.3285 8.51812C11.4813 9.38524 10.7088 10.3268 10.0198 11.3321C8.55457 11.1953 7.08939 11.3105 5.84189 11.8721C2.31916 13.4706 1.29423 17.6454 1.00817 19.4376C0.992669 19.5358 0.999288 19.6364 1.02751 19.7315C1.05574 19.8267 1.10481 19.9138 1.17093 19.9862C1.23705 20.0586 1.31844 20.1144 1.40878 20.1491C1.49913 20.1838 1.59601 20.1966 1.69192 20.1865L7.34824 19.5456C7.35215 19.9859 7.37777 20.4257 7.42498 20.8633C7.4545 21.1658 7.58527 21.4482 7.79477 21.6618L9.98487 23.9221C10.1921 24.1384 10.466 24.2734 10.7593 24.3037C11.1808 24.3522 11.6044 24.3786 12.0285 24.3829L11.4082 30.2153C11.3985 30.3141 11.411 30.414 11.4446 30.507C11.4783 30.6001 11.5323 30.684 11.6023 30.7521C11.6724 30.8202 11.7567 30.8708 11.8487 30.9C11.9408 30.9291 12.0381 30.936 12.1331 30.9202C13.8704 30.6322 17.9241 29.5744 19.4639 25.9396C20.0081 24.6508 20.1198 23.1466 19.9942 21.6417C20.9712 20.9312 21.8861 20.134 22.7285 19.2591C27.4994 14.3627 30.7849 5.51625 29.8709 1.40551ZM18.4878 12.9162C18.0711 12.4862 17.7873 11.9384 17.6723 11.3419C17.5573 10.7455 17.6162 10.1273 17.8417 9.56541C18.0672 9.00356 18.449 8.52333 18.939 8.18546C19.4289 7.84759 20.005 7.66725 20.5942 7.66725C21.1835 7.66725 21.7595 7.84759 22.2494 8.18546C22.7394 8.52333 23.1212 9.00356 23.3467 9.56541C23.5722 10.1273 23.6311 10.7455 23.5161 11.3419C23.4011 11.9384 23.1173 12.4862 22.7006 12.9162C22.4242 13.202 22.0959 13.4288 21.7344 13.5835C21.373 13.7383 20.9855 13.8179 20.5942 13.8179C20.2029 13.8179 19.8154 13.7383 19.454 13.5835C19.0926 13.4288 18.7642 13.202 18.4878 12.9162Z" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" />
+                                <path d="M29.8709 1.40551C29.8591 1.34642 29.8311 1.29205 29.7903 1.24881C29.7495 1.20556 29.6976 1.17524 29.6407 1.16141C25.8466 0.20375 17.082 3.61605 12.3285 8.51812C11.4813 9.38524 10.7088 10.3268 10.0198 11.3321C8.55457 11.1953 7.08939 11.3105 5.84189 11.8721C2.31916 13.4706 1.29423 17.6454 1.00817 19.4376C0.992669 19.5358 0.999288 19.6364 1.02751 19.7315C1.05574 19.8267 1.10481 19.9138 1.17093 19.9862C1.23705 20.0586 1.31844 20.1144 1.40878 20.1491C1.49913 20.1838 1.59601 20.1966 1.69192 20.1865L7.34824 19.5456C7.35215 19.9859 7.37777 20.4257 7.42498 20.8633C7.4545 21.1658 7.58527 21.4482 7.79477 21.6618L9.98487 23.9221C10.1921 24.1384 10.466 24.2734 10.7593 24.3037C11.1808 24.3522 11.6044 24.3786 12.0285 24.3829L11.4082 30.2153C11.3985 30.31.2 11.411 30.414 11.4446 30.507C11.4783 30.6001 11.5323 30.684 11.6023 30.7521C11.6724 30.8202 11.7567 30.8708 11.8487 30.9C11.9408 30.9291 12.0381 30.936 12.1331 30.9202C13.8704 30.6322 17.9241 29.5744 19.4639 25.9396C20.0081 24.6508 20.1198 23.1466 19.9942 21.6417C20.9712 20.9312 21.8861 20.134 22.7285 19.2591C27.4994 14.3627 30.7849 5.51625 29.8709 1.40551ZM18.4878 12.9162C18.0711 12.4862 17.7873 11.9384 17.6723 11.3419C17.5573 10.7455 17.6162 10.1273 17.8417 9.56541C18.0672 9.00356 18.449 8.52333 18.939 8.18546C19.4289 7.84759 20.005 7.66725 20.5942 7.66725C21.1835 7.66725 21.7595 7.84759 22.2494 8.18546C22.7394 8.52333 23.1212 9.00356 23.3467 9.56541C23.5722 10.1273 23.6311 10.7455 23.5161 11.3419C23.4011 11.9384 23.1173 12.4862 22.7006 12.9162C22.4242 13.202 22.0959 13.4288 21.7344 13.5835C21.373 13.7383 20.9855 13.8179 20.5942 13.8179C20.2029 13.8179 19.8154 13.7383 19.454 13.5835C19.0926 13.4288 18.7642 13.202 18.4878 12.9162Z" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" />
                                <path d="M5.29982 22.8765C4.60428 22.9646 3.95721 23.29 3.46136 23.801C2.232 25.074 2.11548 29.7889 2.11548 29.7889C2.11548 29.7889 6.68686 29.6687 7.91692 28.3985C8.41409 27.8876 8.72993 27.2187 8.81347 26.4997" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" />
                            </svg>
                            Deploy</a>
--- a/docs/networking/dns.md
+++ b/docs/networking/dns.md
@@ -1,6 +1,7 @@
 # DNS Configuration

-> Note: This is a work in progress.
+> [!NOTE]
+> This is a work in progress.

 ## DNS Versions

--- a/docs/networking/network.md
+++ b/docs/networking/network.md
@@ -1,5 +1,6 @@
 # Network Management

+> [!IMPORTANT]
 > New as of 0.11.0, Enhanced in 0.20.0

 ```
@@ -20,6 +21,7 @@ The Network plugin allows developers to abstract the concept of container networ

 ### Listing networks

+> [!IMPORTANT]
 > New as of 0.20.0, Requires Docker 1.21+

 You can easily list all available networks using the `network:list` command:
@@ -51,6 +53,7 @@ test-network

 ### Creating a network

+> [!IMPORTANT]
 > New as of 0.20.0, Requires Docker 1.21+

 Docker networks can be created via the `network:create` command. Executing this command will create an attachable `bridge` network. This can be used to route requests between containers without going through any public network.
@@ -67,6 +70,7 @@ Specifying other additional flags or other types of networks can be created dire

 ### Destroying a network

+> [!IMPORTANT]
 > New as of 0.20.0, Requires Docker 1.21+

 A Docker network without any associated containers may be destroyed via the `network:destroy` command. Docker will refuse to destroy networks that have containers attached.
@@ -75,7 +79,7 @@ A Docker network without any associated containers may be destroyed via the `net
 dokku network:destroy test-network
 ```

-```shell
+```
 !     WARNING: Potentially Destructive Action
 !     This command will destroy network test.
 !     To proceed, type "test"
@@ -89,12 +93,13 @@ As the command is destructive, it will default to asking for confirmation before
 dokku --force network:destroy test-network
 ```

-```shell
+```
 -----> Destroying network test
 ```

 ### Checking if a network exists

+> [!IMPORTANT]
 > New as of 0.20.0, Requires Docker 1.21+

 For CI/CD pipelines, it may be useful to see if an network exists before creating a new network. You can do so via the `network:exists` command:
@@ -111,6 +116,7 @@ The `network:exists` command will return non-zero if the network does not exist,

 ### Checking network info

+> [!IMPORTANT]
 > New as of 0.20.0, Requires Docker 1.21+

 Network information can be retrieved via the `network:info` command. This is a slightly different version of the `docker network` command.
@@ -155,6 +161,7 @@ Only a single `$IP:$PORT` combination can be routed to for a given app, and that

 ### Attaching an app to a network

+> [!IMPORTANT]
 > New as of 0.20.0, Requires Docker 1.21+

 Apps will default to being associated with the default `bridge` network or a network specified by the `initial-network` network property. Additionally, an app can be attached to `attachable` networks by changing the `attach-post-create` or `attach-post-deploy` network properties when using the [docker-local scheduler](/docs/deployment/schedulers/docker-local.md). A change in these values will require an app deploy or rebuild.
@@ -206,7 +213,8 @@ dokku network:set --global initial-network

 #### Network Aliases

-> Note: This feature is only available when an app has been attached to a network other than the default `bridge` network.
+> [!NOTE]
+> This feature is only available when an app has been attached to a network other than the default `bridge` network.

 When a container created for a deployment is being attached to a network - regardless of which network property was used - a network alias of the pattern `APP.PROC_TYPE` will be added to all containers. This can be used to load-balance requests between containers. For an application named `node-js-app` with a process type of web, the network alias - or resolvable DNS record within the network - will be:

@@ -292,7 +300,8 @@ Whatever the reason, the semantics of the two network hooks are important and ar
    - Use case: When another container on the network is already running and needed by this container.
    - Example: A key-value store exposing itself to all your apps may be on the `initial-network`.

-> Warning: If the attachment fails during the `running` container state, this may result in your application failing to respond to proxied requests once older containers are removed.
+> [!WARNING]
+> If the attachment fails during the `running` container state, this may result in your application failing to respond to proxied requests once older containers are removed.

 ### Rebuilding network settings

@@ -344,7 +353,7 @@ CONTAINER ID        IMAGE                      COMMAND                CREATED

 As such, the container's IP address will be an internal IP, and thus it is only accessible on the host itself:

-```
+```shell
 docker inspect --format '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' node-js-app.web.1
 ```

--- a/docs/networking/port-management.md
+++ b/docs/networking/port-management.md
@@ -1,5 +1,6 @@
 # Port Management

+> [!IMPORTANT]
 > New as of 0.31.0, replaces the previous `proxy:ports*` commands

 ```
@@ -12,7 +13,8 @@ ports:set <app> <scheme>:<host-port>:<container-port> [<scheme>:<host-port>:<con

 ## Usage

-> Warning: Mapping alternative ports may conflict with the active firewall installed on your server or hosting provider. Such software includes - but is not limited to - AWS Security Groups, iptables, and UFW. Please consult the documentation for those softwares as applicable.
+> [!WARNING]
+> Mapping alternative ports may conflict with the active firewall installed on your server or hosting provider. Such software includes - but is not limited to - AWS Security Groups, iptables, and UFW. Please consult the documentation for those softwares as applicable.
 >
 > Users should also avoid setting the `PORT` environment variable. Dokku will use port mappings to set this value. Overriding this manually may cause issues in application routing.

@@ -20,7 +22,8 @@ You can now configure `host -> container` port mappings with the `ports:*` comma

 By default, buildpack apps and dockerfile apps **without** explicitly exposed ports (i.e. using the `EXPOSE` directive) will be configured with a listener on port `80` (and additionally a listener on 443 if ssl is enabled) that will proxy to the application container on port `5000`. Dockerfile apps **with** explicitly exposed ports will be configured with a listener on each exposed port and will proxy to that same port of the deployed application container.

-> Note: This default behavior **will not** be automatically changed on subsequent pushes and must be manipulated with the `ports:*` commands detailed below.
+> [!NOTE]
+> This default behavior **will not** be automatically changed on subsequent pushes and must be manipulated with the `ports:*` commands detailed below.

 ### Port Scheme

@@ -28,8 +31,7 @@ The proxy port scheme is as follows:

 - `SCHEME:HOST_PORT:CONTAINER_PORT`

-The scheme metadata can be used by proxy implementations in order to properly handle proxying of requests. For example, the built-in `nginx-vhosts` proxy implementation supports the `http`, `https`, `grpc` and `grpcs` schemes. 
-For the `grpc` and `grpcs` see [nginx blog post on grpc](https://www.nginx.com/blog/nginx-1-13-10-grpc/).
+The scheme metadata can be used by proxy implementations in order to properly handle proxying of requests. For example, the built-in `nginx-vhosts` proxy implementation supports the `http`, `https`, `grpc` and `grpcs` schemes. For the `grpc` and `grpcs` see [nginx blog post on grpc](https://www.nginx.com/blog/nginx-1-13-10-grpc/).

 Developers of proxy implementations are encouraged to use whatever schemes make the most sense, and ignore configurations which they do not support. For instance, a `udp` proxy implementation can safely ignore `http` and `https` port mappings.

@@ -139,7 +141,8 @@ dokku ports:remove node-js-app http:80

 ## Port management by Deployment Method

-> Warning: If you set a port map but _do not have a global domain set_, Dokku will reset that map upon first deployment.
+> [!WARNING]
+> If you set a port map but _do not have a global domain set_, Dokku will reset that map upon first deployment.

 ### Buildpacks

--- a/docs/networking/proxies/caddy.md
+++ b/docs/networking/proxies/caddy.md
@@ -1,5 +1,6 @@
 # Caddy Proxy

+> [!IMPORTANT]
 > New as of 0.28.0

 Dokku provides integration with the [Caddy](https://caddyserver.com/) proxy service by utilizing the Docker label-based integration implemented by Caddy.
@@ -19,7 +20,8 @@ Using the `caddy` plugin integration requires the `docker-compose-plugin` for Do

 ## Usage

-> Warning: As using multiple proxy plugins on a single Dokku installation can lead to issues routing requests to apps, doing so should be avoided. As the default proxy implementation is nginx, users are encouraged to stop the nginx service before switching to Caddy.
+> [!WARNING]
+> As using multiple proxy plugins on a single Dokku installation can lead to issues routing requests to apps, doing so should be avoided. As the default proxy implementation is nginx, users are encouraged to stop the nginx service before switching to Caddy.

 The Caddy plugin has specific rules for routing requests:

--- a/docs/networking/proxies/haproxy.md
+++ b/docs/networking/proxies/haproxy.md
@@ -1,5 +1,6 @@
 # Haproxy Proxy

+> [!IMPORTANT]
 > New as of 0.28.0

 Dokku provides integration with the [Haproxy](http://www.haproxy.org) proxy service by utilizing the Docker label-based integration implemented by [EasyHaproxy](https://github.com/byjg/docker-easy-haproxy).
@@ -19,7 +20,8 @@ Using the `haproxy` plugin integration requires the `docker-compose-plugin` for

 ## Usage

-> Warning: As using multiple proxy plugins on a single Dokku installation can lead to issues routing requests to apps, doing so should be avoided. As the default proxy implementation is nginx, users are encouraged to stop the nginx service before switching to Haproxy.
+> [!WARNING]
+> As using multiple proxy plugins on a single Dokku installation can lead to issues routing requests to apps, doing so should be avoided. As the default proxy implementation is nginx, users are encouraged to stop the nginx service before switching to Haproxy.

 The Haproxy plugin has specific rules for routing requests:

--- a/docs/networking/proxies/nginx.md
+++ b/docs/networking/proxies/nginx.md
@@ -15,7 +15,8 @@ nginx:validate-config [<app>] [--clean]  # Validates and optionally cleans up in

 ## Usage

-> Warning: As using multiple proxy plugins on a single Dokku installation can lead to issues routing requests to apps, doing so should be avoided.
+> [!WARNING]
+> As using multiple proxy plugins on a single Dokku installation can lead to issues routing requests to apps, doing so should be avoided.

 ### Request Proxying

@@ -23,10 +24,12 @@ By default, the `web` process is the only process proxied by the nginx proxy imp

 Nginx will proxy the requests in a [round-robin balancing fashion](http://nginx.org/en/docs/http/ngx_http_upstream_module.html#upstream) to the different deployed (scaled) containers running the `web` proctype. This way, the host's resources can be fully leveraged for single-threaded applications (e.g. `dokku ps:scale node-js-app web=4` on a 4-core machine).

-> Note: Due to how the plugin is implemented, if an app successfully starts up `web` containers but fails to deploy some other containers, nginx may eventually stop routing requests. Users should revert their code in these cases, or manually trigger `dokku proxy:build-config $APP` in order to ensure requests route to the new web containers.
+> [!NOTE]
+> Due to how the plugin is implemented, if an app successfully starts up `web` containers but fails to deploy some other containers, nginx may eventually stop routing requests. Users should revert their code in these cases, or manually trigger `dokku proxy:build-config $APP` in order to ensure requests route to the new web containers.

 ### Starting nginx

+> [!IMPORTANT]
 > New as of 0.28.0

 The nginx server can be started via `nginx:start`.
@@ -37,6 +40,7 @@ dokku nginx:start

 ### Stopping nginx

+> [!IMPORTANT]
 > New as of 0.28.0

 The nginx server can be stopped via `nginx:stop`.
@@ -47,9 +51,11 @@ dokku nginx:stop

 ### Binding to specific addresses

+> [!IMPORTANT]
 > New as of 0.19.2

-> Note: Changing this value globally or on a per-app basis will require rebuilding the nginx config via the `proxy:build-config` command.
+> [!NOTE]
+> Changing this value globally or on a per-app basis will require rebuilding the nginx config via the `proxy:build-config` command.

 By default, nginx will listen to all interfaces (`[::]` for IPv6, `0.0.0.0` for IPv4) when proxying requests to applications. This may be changed using the `bind-address-ipv4` and `bind-address-ipv6` properties. This is useful in cases where the proxying should be internal to a network or if there are multiple network interfaces that should respond with different content.

@@ -65,15 +71,18 @@ dokku nginx:set node-js-app bind-address-ipv4
 dokku nginx:set node-js-app bind-address-ipv6
 ```

-> Warning: Validation is not performed on either value.
+> [!WARNING]
+> Validation is not performed on either value.

 Users with apps that contain a custom `nginx.conf.sigil` file will need to modify the files to respect the new `NGINX_BIND_ADDRESS_IPV4` and `NGINX_BIND_ADDRESS_IPV6` variables.

 ### HSTS Header

+> [!IMPORTANT]
 > New as of 0.20.0

-> Note: Changing this value globally or on a per-app basis will require rebuilding the nginx config via the `proxy:build-config` command.
+> [!NOTE]
+> Changing this value globally or on a per-app basis will require rebuilding the nginx config via the `proxy:build-config` command.

 If SSL certificates are present, HSTS will be automatically enabled. It can be toggled via `nginx:set`:

@@ -93,7 +102,8 @@ Beware that if you enable the header and a subsequent deploy of your application

 #### Globally disabling the HSTS Header

-> Note: Changing this value globally or on a per-app basis will require rebuilding the nginx config via the `proxy:build-config` command.
+> [!NOTE]
+> Changing this value globally or on a per-app basis will require rebuilding the nginx config via the `proxy:build-config` command.

 HSTS Header can be disabled for all apps by setting the `hsts` property to false after passing the `--global` flag to `nginx:set`.

@@ -107,7 +117,7 @@ Once the HSTS setting is disabled globally, it can be re-enabled on a per-app ba
 dokku nginx:set node-js-app hsts true
 ```

-### Running behind another proxy — configuring `X-Forwarded-*` headers:
+### Running behind another proxy — configuring `X-Forwarded-*` headers

 Dokku's default Nginx configuration passes the de-facto standard HTTP headers [`X-Forwarded-For`](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Forwarded-For), [`X-Forwarded-Proto`](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Forwarded-Proto), and `X-Forwarded-Port` to your application.
 These headers indicate the IP address of the original client making the request, the protocol of the original request (HTTP or HTTPS), and the port number of the original request, respectively.
@@ -145,7 +155,8 @@ dokku nginx:set node-js-app x-forwarded-ssl

 ### Checking access logs

-> Note: Changing this value globally or on a per-app basis will require rebuilding the nginx config via the `proxy:build-config` command.
+> [!NOTE]
+> Changing this value globally or on a per-app basis will require rebuilding the nginx config via the `proxy:build-config` command.

 You may check nginx access logs via the `nginx:access-logs` command. This assumes that app access logs are being stored in `/var/log/nginx/$APP-access.log`, as is the default in the generated `nginx.conf`.

@@ -175,9 +186,11 @@ dokku nginx:error-logs node-js-app -t

 ### Changing log path

+> [!IMPORTANT]
 > New as of 0.20.1

-> Note: Changing this value globally or on a per-app basis will require rebuilding the nginx config via the `proxy:build-config` command.
+> [!NOTE]
+> Changing this value globally or on a per-app basis will require rebuilding the nginx config via the `proxy:build-config` command.

 The path to where log files are stored can be changed by calling the `nginx:set` command with the following options:

@@ -202,9 +215,11 @@ In all cases, the nginx config must be regenerated after setting the above value

 ### Changing log format

+> [!IMPORTANT]
 > New as of 0.22.0

-> Note: Changing this value globally or on a per-app basis will require rebuilding the nginx config via the `proxy:build-config` command.
+> [!NOTE]
+> Changing this value globally or on a per-app basis will require rebuilding the nginx config via the `proxy:build-config` command.

 The format of the access log can be changed by calling the `nginx:set` command as follows:

@@ -245,9 +260,11 @@ dokku proxy:build-config node-js-app

 ### Specifying a read timeout

+> [!IMPORTANT]
 > New as of 0.21.0

-> Note: Changing this value globally or on a per-app basis will require rebuilding the nginx config via the `proxy:build-config` command.
+> [!NOTE]
+> Changing this value globally or on a per-app basis will require rebuilding the nginx config via the `proxy:build-config` command.

 When proxying requests to your applications, it may be useful to specify a proxy read timeout. This can be done via the `nginx:set` command as follows:

@@ -267,9 +284,11 @@ In all cases, the nginx config must be regenerated after setting the above value

 ### Specifying a custom client_max_body_size

+> [!IMPORTANT]
 > New as of 0.23.0

-> Note: Changing this value globally or on a per-app basis will require rebuilding the nginx config via the `proxy:build-config` command.
+> [!NOTE]
+> Changing this value globally or on a per-app basis will require rebuilding the nginx config via the `proxy:build-config` command.

 Users can override the default `client_max_body_size` value - which limits file uploads - via `nginx:set`. Changing this value will only apply to every `server` stanza of the default `nginx.conf.sigil`; users of custom `nginx.conf.sigil` files must update their templates to support the new value.

@@ -309,7 +328,8 @@ As app nginx configs are actually executed within a shared context, it is possib

 The `nginx:validate-config` command also takes an optional `--clean` flag. If specified, invalid nginx configs will be removed.

-> Warning: Invalid app nginx config's will be removed _even if_ the config is valid in the global server context.
+> [!WARNING]
+> Invalid app nginx config's will be removed _even if_ the config is valid in the global server context.

 ```shell
 dokku nginx:validate-config --clean
@@ -323,6 +343,7 @@ dokku nginx:validate-config node-js-app --clean

 ### Customizing the nginx configuration

+> [!IMPORTANT]
 > New as of 0.5.0

 Dokku uses a templating library by the name of [sigil](https://github.com/gliderlabs/sigil) to generate nginx configuration for each app. This may be overriden by committing the [default configuration template](https://github.com/dokku/dokku/blob/master/plugins/nginx-vhosts/templates/nginx.conf.sigil) to a file named `nginx.conf.sigil` in the root of the app repository.
@@ -331,7 +352,6 @@ When deploying a monorepo, it may be desirable to specify the specific path of t

 For deploys via the `git:from-image` and `git:load-image` commands, the `nginx.conf.sigil` is extracted from the configured `WORKDIR` property of the image. For all other deploys - git push, `git:from-archive`, `git:sync` - will have the `nginx.conf.sigil` extracted directly from the source code. Both cases will respect the configured `nginx-conf-sigil-path` property value.

-
 ```shell
 dokku nginx:set node-js-app nginx-conf-sigil-path .dokku/nginx.conf.sigil
 ```
@@ -353,7 +373,8 @@ dokku nginx:set --global nginx-conf-sigil-path

 #### Disabling custom nginx config

-> Note: Changing this value globally or on a per-app basis will require rebuilding the nginx config via the `proxy:build-config` command.
+> [!NOTE]
+> Changing this value globally or on a per-app basis will require rebuilding the nginx config via the `proxy:build-config` command.

 While enabled by default, using a custom nginx config can be disabled via `nginx:set`. This may be useful in cases where you do not want to allow users to override any higher-level customization of app nginx config.

@@ -384,7 +405,8 @@ Unsetting this value is the same as enabling custom nginx config usage.

 Finally, each process type has it's network listeners - a list of IP:PORT pairs for the respective app containers - exposed via an `.DOKKU_APP_${PROCESS_TYPE}_LISTENERS` variable - the `PROCESS_TYPE` will be upper-cased with hyphens transformed into underscores. Users can use the new variables to expose non-web processes via the nginx proxy.

-> Note: Application environment variables are available for use in custom templates. To do so, use the form of `{{ var "FOO" }}` to access a variable named `FOO`.
+> [!NOTE]
+> Application environment variables are available for use in custom templates. To do so, use the form of `{{ var "FOO" }}` to access a variable named `FOO`.

 #### Customizing via configuration files included by the default templates

@@ -437,7 +459,8 @@ These are provided as an alternative to the generic Nginx error page, are shared

 By default, Dokku will route any received request with an unknown HOST header value to the lexicographically first site in the nginx config stack. This means that accessing the dokku server via its IP address or a bogus domain name may return a seemingly random website.

-> Warning: some versions of Nginx may create a default site when installed. This site is simply a static page which says "Welcome to Nginx", and if this default site is enabled, Nginx will not route any requests with an unknown HOST header to Dokku. If you want Dokku to receive all requests, run the following commands:
+> [!WARNING]
+> some versions of Nginx may create a default site when installed. This site is simply a static page which says "Welcome to Nginx", and if this default site is enabled, Nginx will not route any requests with an unknown HOST header to Dokku. If you want Dokku to receive all requests, run the following commands:
 >
 > ```
 > rm /etc/nginx/sites-enabled/default
--- a/docs/networking/proxies/openresty.md
+++ b/docs/networking/proxies/openresty.md
@@ -1,5 +1,6 @@
 # OpenResty Proxy

+> [!IMPORTANT]
 > New as of 0.31.0

 Dokku can provide integration with the [OpenResty](https://openresty.org/) proxy service by utilizing the Docker label-based integration implemented by [openresty-docker-proxy](https://github.com/dokku/openresty-docker-proxy).
@@ -19,7 +20,8 @@ Using the `openresty` plugin integration requires the `docker-compose-plugin` fo

 ## Usage

-> Warning: As using multiple proxy plugins on a single Dokku installation can lead to issues routing requests to apps, doing so should be avoided. As the default proxy implementation is nginx, users are encouraged to stop the nginx service before switching to OpenResty.
+> [!WARNING]
+> As using multiple proxy plugins on a single Dokku installation can lead to issues routing requests to apps, doing so should be avoided. As the default proxy implementation is nginx, users are encouraged to stop the nginx service before switching to OpenResty.

 The OpenResty plugin has specific rules for routing requests:

--- a/docs/networking/proxies/traefik.md
+++ b/docs/networking/proxies/traefik.md
@@ -1,5 +1,6 @@
 # Traefik Proxy

+> [!IMPORTANT]
 > New as of 0.28.0

 Dokku provides integration with the [Traefik](https://traefik.io/) proxy service by utilizing the Docker label-based integration implemented by Traefik.
@@ -19,7 +20,8 @@ Using the `traefik` plugin integration requires the `docker-compose-plugin` for

 ## Usage

-> Warning: As using multiple proxy plugins on a single Dokku installation can lead to issues routing requests to apps, doing so should be avoided. As the default proxy implementation is nginx, users are encouraged to stop the nginx service before switching to Traefik.
+> [!WARNING]
+> As using multiple proxy plugins on a single Dokku installation can lead to issues routing requests to apps, doing so should be avoided. As the default proxy implementation is nginx, users are encouraged to stop the nginx service before switching to Traefik.

 The Traefik plugin has specific rules for routing requests:

@@ -154,7 +156,8 @@ Traefik exposes an API and Dashboard, which Dokku disables by default for securi

 #### Enabling the api

-> Warning: Users enabling the dashboard should also enable api basic auth.
+> [!WARNING]
+> Users enabling the dashboard should also enable api basic auth.

 By default, the api is disabled. To enable, set the `api` property with the `--global` flag:

@@ -166,7 +169,8 @@ After enabling, the Traefik container will need to be restarted.

 #### Enabling the dashboard

-> Warning: Users enabling the dashboard should also enable api basic auth.
+> [!WARNING]
+> Users enabling the dashboard should also enable api basic auth.

 By default, the dashboard is disabled. To enable, set the `dashboard` property with the `--global` flag:

--- a/docs/networking/proxy-management.md
+++ b/docs/networking/proxy-management.md
@@ -1,5 +1,6 @@
 # Proxy Management

+> [!IMPORTANT]
 > New as of 0.5.0, Enhanced in 0.6.0

 ```
@@ -43,6 +44,7 @@ dokku proxy:build-config --all --parallel -1

 ### Clearing the generated proxy config

+> [!IMPORTANT]
 > New as of 0.27.0

 Generated proxy configurations can also be cleared using the `proxy:clear-config` command.
@@ -61,6 +63,7 @@ Clearing a proxy configuration has different effects depending on the proxy plug

 ### Displaying proxy reports for an app

+> [!IMPORTANT]
 > New as of 0.8.1

 You can get a report about the app's proxy status using the `proxy:report` command:
@@ -117,36 +120,36 @@ From Dokku versions `0.5.0` until `0.11.0`, enabling or disabling an application

 Custom plugins names _must_ have the suffix `-vhosts` or scheduler overriding via `proxy:set` may not function as expected.

-At this time, the following dokku commands are used to interact with a complete proxy implementation. 
+At this time, the following dokku commands are used to interact with a complete proxy implementation.

 - `domains:add`: Adds a given domain to an app.
-  - triggers: `post-domains-update`
+    - triggers: `post-domains-update`
 - `domains:clear`: Clears out an app's associated domains.
-  - triggers: `post-domains-update`
+    - triggers: `post-domains-update`
 - `domains:disable`: Disables domains for an app.
-  - triggers: `pre-disable-vhost`
+    - triggers: `pre-disable-vhost`
 - `domains:enable`: Enables domains for an app.
-  - triggers: `pre-enable-vhost`
+    - triggers: `pre-enable-vhost`
 - `domains:remove`: Removes a domain from an app.
-  - triggers: `post-domains-update`
+    - triggers: `post-domains-update`
 - `domains:set`: Sets all domains for a given app.
-  - triggers: `post-domains-update`
+    - triggers: `post-domains-update`
 - `proxy:build-config`: Builds - or rebuilds - external proxy configuration.
-  - triggers: `proxy-build-config`
+    - triggers: `proxy-build-config`
 - `proxy:clear-config`: Clears out external proxy configuration.
-  - triggers: `proxy-clear-config`
+    - triggers: `proxy-clear-config`
 - `proxy:disable`: Disables the proxy configuration for an app.
-  - triggers: `proxy-disable`
+    - triggers: `proxy-disable`
 - `proxy:enable`: Enables the proxy configuration for an app.
-  - triggers: `proxy-enable`
+    - triggers: `proxy-enable`
 - `ports:add`: Adds one or more port mappings to an app
-  - triggers: `post-proxy-ports-update`
+    - triggers: `post-proxy-ports-update`
 - `ports:clear`: Clears out all port mappings for an app.
-  - triggers: `post-proxy-ports-update`
+    - triggers: `post-proxy-ports-update`
 - `ports:remove`: Removes one or more port mappings from an app.
-  - triggers: `post-proxy-ports-update`
+    - triggers: `post-proxy-ports-update`
 - `ports:set`: Sets all port mappings for an app.
-  - triggers: `post-proxy-ports-update`
+    - triggers: `post-proxy-ports-update`

 Proxy implementations may decide to omit some functionality here, or use plugin triggers to supplement config with information from other plugins.

--- a/docs/processes/entering-containers.md
+++ b/docs/processes/entering-containers.md
@@ -1,5 +1,6 @@
 # Entering containers

+> [!IMPORTANT]
 > New as of 0.4.0

 ```
--- a/docs/processes/one-off-tasks.md
+++ b/docs/processes/one-off-tasks.md
@@ -16,6 +16,7 @@ Sometimes it is necessary to run a one-off command under an app. Dokku makes it

 The `run` command can be used to run a one-off process for a specific command. This will start a new container and run the desired command within that container.  The container image will be the same container image as was used to start the currently deployed app.

+> [!IMPORTANT]
 > New as of 0.25.0, this container will be removed after the process exits.

 ```shell
@@ -51,6 +52,7 @@ dokku --label=com.example.test-label=value run node-js-app ls -lah

 #### Disabling TTY

+> [!IMPORTANT]
 > New as of 0.25.0

 One-off containers default to interactive mode where possible. To disable this behavior, specify the `--no-tty` flag:
@@ -61,6 +63,7 @@ dokku run --no-tty node-js-app ls -lah

 ### Running a detached container

+> [!IMPORTANT]
 > New as of 0.25.0

 Finally, a container can be run in "detached" mode via the `run:detached` Dokku command. Running a process in detached mode will immediately return a `CONTAINER_ID`. Detached containers are run without a tty and are also removed at the end of process execution.
@@ -101,6 +104,7 @@ The above command will show logs continually from the `node-js-app.run.1234` one

 ### Listing one-off containers

+> [!IMPORTANT]
 > New as of 0.25.0

 One-off containers for a given app can be listed via the `run:list` command:
@@ -136,6 +140,7 @@ dokku run:list node-js-app --format json

 ### Stopping a one-off container

+> [!IMPORTANT]
 > New as of 0.29.0

 Run containers for an app can be stopped via the `run:stop` command. The output will be the container id.
--- a/docs/processes/process-management.md
+++ b/docs/processes/process-management.md
@@ -1,5 +1,6 @@
 # Process Management

+> [!IMPORTANT]
 > New as of 0.3.14, Enhanced in 0.7.0

 ```
@@ -18,6 +19,7 @@ ps:stop [--parallel count] [--all|<app>]                          # Stop an app

 ### Inspecting app containers

+> [!IMPORTANT]
 > New as of 0.13.0

 A common administrative task to perform is calling `docker inspect` on the containers that are running for an app. This can be an error-prone task to perform, and may also reveal sensitive environment variables if not done correctly. Dokku provides a wrapper around this command via the `ps:inspect` command:
@@ -109,7 +111,8 @@ web:  1

 #### Procfile

-> Note: Dokku supports the Procfile format as defined in [this document](https://github.com/dokku/procfile-util/blob/master/PROCFILE_FORMAT.md) under "Strict Mode" parsing rules.
+> [!NOTE]
+> Dokku supports the Procfile format as defined in [this document](https://github.com/dokku/procfile-util/blob/master/PROCFILE_FORMAT.md) under "Strict Mode" parsing rules.

 Apps can define processes to run by using a `Procfile`. A `Procfile` is a simple text file that can be used to specify multiple commands, each of which is subject to process scaling. In the case where the built image sets a default command to run - either through usage of `CMD` for Dockerfile-based builds, a default process for buildpack-based builds, or any other method for the builder in use - the `Procfile` will take precedence.

@@ -117,7 +120,7 @@ If the file exists, it should not be empty, as doing so may result in a failed d

 The syntax for declaring a `Procfile` is as follows. Note that the format is one process type per line, with no duplicate process types.

-```
+```Procfile
 <process type>: <command>
 ```

@@ -141,7 +144,7 @@ For initial app deploys, Dokku will default to starting a single `web` process f
 There are also a few other exceptions for the `web` process.

 - By default, the built-in nginx proxy implementation only proxies the `web` process (others may be handled via a custom `nginx.conf.sigil`).
-  - See the [nginx request proxying documentation](/docs/networking/proxies/nginx.md#request-proxying) for more information on how nginx handles proxied requests.
+    - See the [nginx request proxying documentation](/docs/networking/proxies/nginx.md#request-proxying) for more information on how nginx handles proxied requests.
 - Only the `web` process may be bound to an external port.

 #### The `release` process
@@ -206,7 +209,7 @@ dokku ps:scale --skip-deploy node-js-app web=1

 Users can also configure scaling within the codebase itself to manage process scaling. The `formation` key should be specified as follows in the `app.json` file:

-```Procfile
+```json
 {
  "formation": {
    "web": {
@@ -277,6 +280,7 @@ dokku ps:start --all --parallel -1

 ### Restart policies

+> [!IMPORTANT]
 > New as of 0.7.0, Command Changed in 0.22.0

 By default, Dokku will automatically restart containers that exit with a non-zero status up to 10 times via the [on-failure Docker restart policy](https://docs.docker.com/engine/reference/run/#restart-policies---restart).
@@ -313,6 +317,7 @@ Dokku also runs `dokku-event-listener` in the background via the system's init s

 ### Displaying reports for an app

+> [!IMPORTANT]
 > New as of 0.12.0

 You can get a report about the deployed apps using the `ps:report` command:
@@ -383,7 +388,7 @@ When a server reboots or Docker is restarted/upgraded, Docker may or may not sta
 - Start all linked services.
 - Clear generated proxy configuration files.
 - Start the app if it has not been manually stopped.
-  - If the app containers still exist, they will be started and the generated proxy configuration files will be rebuilt.
-  - If any of the app containers are missing, the entire app will be rebuilt.
+    - If the app containers still exist, they will be started and the generated proxy configuration files will be rebuilt.
+    - If any of the app containers are missing, the entire app will be rebuilt.

 During this time, requests may route to the incorrect app if the assigned IPs correspond to those for other apps. While dokku makes all efforts to avoid this, there may be a few minutes where urls may route to the wrong app. To avoid this, either use a custom proxy plugin or wait a few minutes until the restoration process is complete.
--- a/docs/processes/scheduled-cron-tasks.md
+++ b/docs/processes/scheduled-cron-tasks.md
@@ -1,5 +1,6 @@
 # Scheduled Cron Tasks

+> [!IMPORTANT]
 > New as of 0.23.0

 ```
@@ -18,7 +19,7 @@ Dokku automates scheduled `dokku run` commands via it's `app.json` cron integrat

 The `app.json` file for a given app can define a special `cron` key that contains a list of commands to run on given schedules. The following is a simple example `app.json` that effectively runs the command `dokku run $APP npm run send-email` once a day:

-```
+```json
 {
  "cron": [
    {
@@ -125,7 +126,8 @@ dokku cron:report node-js-app --cron-task-count

 ### Self Managed Cron

-> Warning: Self-managed cron tasks should be considered advanced usage. While the instructions are available, users are highly encouraged to use the built-in scheduled cron task support unless absolutely necessary.
+> [!WARNING]
+> Self-managed cron tasks should be considered advanced usage. While the instructions are available, users are highly encouraged to use the built-in scheduled cron task support unless absolutely necessary.

 Some installations may require more fine-grained control over cron usage. The following are advanced instructions for configuring cron.

@@ -168,8 +170,7 @@ For tasks that will properly resume, you _should_ use the above method, as runni
 Regularly scheduled tasks can be a bit of a pain with Dokku. The following are general recommendations to follow to help ensure successful task runs.

 - Use the `dokku` user in your cron entry.
-  - If you do not, the `dokku` binary will attempt to execute with `sudo`, and your cron run with fail with `sudo: no tty present and no askpass program specified`.
-
+    - If you do not, the `dokku` binary will attempt to execute with `sudo`, and your cron run with fail with `sudo: no tty present and no askpass program specified`.
 - Add a `MAILTO` environment variable to ship cron emails to yourself.
 - Add a `PATH` environment variable or specify the full path to binaries on the host.
 - Add a `SHELL` environment variable to specify Bash when running commands.
--- a/docs/template.html
+++ b/docs/template.html
@@ -9,26 +9,26 @@
    <meta name="author" content="">
    <title>Dokku - {{DOC_TITLE}}</title>

-    <link rel="apple-touch-icon" sizes="57x57" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.0/docs/assets/favicons/apple-touch-icon-57x57.png">
-    <link rel="apple-touch-icon" sizes="60x60" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.0/docs/assets/favicons/apple-touch-icon-60x60.png">
-    <link rel="apple-touch-icon" sizes="72x72" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.0/docs/assets/favicons/apple-touch-icon-72x72.png">
-    <link rel="apple-touch-icon" sizes="76x76" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.0/docs/assets/favicons/apple-touch-icon-76x76.png">
-    <link rel="apple-touch-icon" sizes="114x114" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.0/docs/assets/favicons/apple-touch-icon-114x114.png">
-    <link rel="apple-touch-icon" sizes="120x120" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.0/docs/assets/favicons/apple-touch-icon-120x120.png">
-    <link rel="apple-touch-icon" sizes="144x144" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.0/docs/assets/favicons/apple-touch-icon-144x144.png">
-    <link rel="apple-touch-icon" sizes="152x152" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.0/docs/assets/favicons/apple-touch-icon-152x152.png">
-    <link rel="apple-touch-icon" sizes="180x180" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.0/docs/assets/favicons/apple-touch-icon-180x180.png">
-    <link rel="icon" type="image/png" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.0/docs/assets/favicons/favicon-32x32.png" sizes="32x32">
-    <link rel="icon" type="image/png" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.0/docs/assets/favicons/android-chrome-192x192.png" sizes="192x192">
-    <link rel="icon" type="image/png" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.0/docs/assets/favicons/favicon-96x96.png" sizes="96x96">
-    <link rel="icon" type="image/png" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.0/docs/assets/favicons/favicon-16x16.png" sizes="16x16">
-    <link rel="manifest" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.0/docs/assets/favicons/manifest.json">
-    <link rel="shortcut icon" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.0/docs/assets/favicons/favicon.ico">
+    <link rel="apple-touch-icon" sizes="57x57" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.2/docs/assets/favicons/apple-touch-icon-57x57.png">
+    <link rel="apple-touch-icon" sizes="60x60" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.2/docs/assets/favicons/apple-touch-icon-60x60.png">
+    <link rel="apple-touch-icon" sizes="72x72" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.2/docs/assets/favicons/apple-touch-icon-72x72.png">
+    <link rel="apple-touch-icon" sizes="76x76" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.2/docs/assets/favicons/apple-touch-icon-76x76.png">
+    <link rel="apple-touch-icon" sizes="114x114" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.2/docs/assets/favicons/apple-touch-icon-114x114.png">
+    <link rel="apple-touch-icon" sizes="120x120" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.2/docs/assets/favicons/apple-touch-icon-120x120.png">
+    <link rel="apple-touch-icon" sizes="144x144" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.2/docs/assets/favicons/apple-touch-icon-144x144.png">
+    <link rel="apple-touch-icon" sizes="152x152" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.2/docs/assets/favicons/apple-touch-icon-152x152.png">
+    <link rel="apple-touch-icon" sizes="180x180" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.2/docs/assets/favicons/apple-touch-icon-180x180.png">
+    <link rel="icon" type="image/png" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.2/docs/assets/favicons/favicon-32x32.png" sizes="32x32">
+    <link rel="icon" type="image/png" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.2/docs/assets/favicons/android-chrome-192x192.png" sizes="192x192">
+    <link rel="icon" type="image/png" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.2/docs/assets/favicons/favicon-96x96.png" sizes="96x96">
+    <link rel="icon" type="image/png" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.2/docs/assets/favicons/favicon-16x16.png" sizes="16x16">
+    <link rel="manifest" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.2/docs/assets/favicons/manifest.json">
+    <link rel="shortcut icon" href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.2/docs/assets/favicons/favicon.ico">
    <meta name="apple-mobile-web-app-title" content="Dokku">
    <meta name="application-name" content="Dokku">
    <meta name="msapplication-TileColor" content="#da532c">
-    <meta name="msapplication-TileImage" content="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.0/docs/assets/favicons/mstile-144x144.png">
-    <meta name="msapplication-config" content="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.0/docs/assets/favicons/browserconfig.xml">
+    <meta name="msapplication-TileImage" content="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.2/docs/assets/favicons/mstile-144x144.png">
+    <meta name="msapplication-config" content="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.2/docs/assets/favicons/browserconfig.xml">
    <meta name="theme-color" content="#ffffff">

    <script>
@@ -48,7 +48,7 @@
    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
    <link href="https://fonts.googleapis.com/css2?family=Lato:wght@400;700;900&display=swap" rel="stylesheet">

-    <link href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.0/docs/assets/style.css" rel="stylesheet">
+    <link href="https://cdn.jsdelivr.net/gh/dokku/dokku@v0.31.2/docs/assets/style.css" rel="stylesheet">
    <!-- <link href="./assets/style.css" rel="stylesheet"> -->
    <link href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.5.0/css/font-awesome.min.css" rel="stylesheet">
  </head>
--- a/plugins/00_dokku-standard/plugin.toml
+++ b/plugins/00_dokku-standard/plugin.toml
@@ -1,4 +1,4 @@
 [plugin]
 description = "dokku core standard plugin"
-version = "0.31.0"
+version = "0.31.2"
 [plugin.config]
--- a/plugins/20_events/app-list
+++ b/plugins/20_events/app-list
@@ -1,6 +0,0 @@
-#!/usr/bin/env bash
-set -eo pipefail
-[[ $DOKKU_TRACE ]] && set -x
-source "$PLUGIN_CORE_AVAILABLE_PATH/common/functions"
-
-[[ ! "$DOKKU_EVENTS" ]] || dokku_log_plugn_trigger_call "$(basename "$0")" "$@"
--- a/plugins/20_events/app-list
+++ b/plugins/20_events/app-list
@@ -0,0 +1 @@
+hook
--- a/plugins/20_events/network-compute-ports
+++ b/plugins/20_events/network-compute-ports
--- a/plugins/20_events/builder-herokuish-allowed
+++ b/plugins/20_events/builder-herokuish-allowed
--- a/plugins/20_events/buildpack-stack-name
+++ b/plugins/20_events/buildpack-stack-name
--- a/plugins/20_events/post-release-buildpack
+++ b/plugins/20_events/post-release-buildpack
--- a/plugins/20_events/haproxy-template-source
+++ b/plugins/20_events/haproxy-template-source
--- a/plugins/20_events/openresty-template-source
+++ b/plugins/20_events/openresty-template-source
--- a/plugins/20_events/plugin.toml
+++ b/plugins/20_events/plugin.toml
@@ -1,4 +1,4 @@
 [plugin]
 description = "dokku core events logging plugin"
-version = "0.31.0"
+version = "0.31.2"
 [plugin.config]
--- a/plugins/20_events/ports-get-property
+++ b/plugins/20_events/ports-get-property
--- a/plugins/20_events/post-build-lambda
+++ b/plugins/20_events/post-build-lambda
--- a/plugins/20_events/post-release-lambda
+++ b/plugins/20_events/post-release-lambda
--- a/plugins/20_events/procfile-extract
+++ b/plugins/20_events/procfile-extract
--- a/plugins/20_events/pre-build-lambda
+++ b/plugins/20_events/pre-build-lambda
--- a/plugins/20_events/profile-get-command
+++ b/plugins/20_events/profile-get-command
--- a/plugins/20_events/scheduler-post-deploy-process
+++ b/plugins/20_events/scheduler-post-deploy-process
--- a/plugins/20_events/scheduler-run-stop
+++ b/plugins/20_events/scheduler-run-stop
@@ -0,0 +1 @@
+hook
--- a/Show More
+++ b/Show More