docs/appendices/0.37.0-migration-guide.md

# 0.37.0 Migration Guide

## Changes

- The `app.json` file format is now parsed as JSONC and supports inline comments.
- The `scheduler-k3s:cluster-add` command is now `scheduler-k3s:cluster:add`.
- The `scheduler-k3s:cluster-list` command is now `scheduler-k3s:cluster:list`.
- The `scheduler-k3s:cluster-remove` command is now `scheduler-k3s:cluster:remove`.

## Removals

- Support for the `DOKKU_DOCKERFILE_CACHE_BUILD` environment variable has been removed. Use the `docker-options` plugin to set build arguments for your app instead.
- Support for the `DOKKU_DOCKER_BUILD_OPTS` environment variable has been removed. Use the `docker-options` plugin to set build arguments for your app instead.
- Support for the `no-cache` nixpacks property has been removed. Use the `docker-options` plugin to set build arguments for your app instead.
- Support for customizing the label-key for the caddy proxy has been removed. Always use `caddy.` as a prefix for your caddy directives.
Fix version 2025-11-30 19:29:05 +09:00			`# 0.37.0 Migration Guide`
refactor: remove support for DOKKU_DOCKERFILE_CACHE_BUILD This replicates the docker-options functionality. 2025-11-15 23:27:22 -05:00
feat: support inline comments for app.json Closes #8007 2025-11-17 00:26:05 -05:00			`## Changes`

			- The `app.json` file format is now parsed as JSONC and supports inline comments.
refactor: rename the scheduler-k3s:cluster-* commands to use a : instead of - for a delimiter This standardizes the commands with the other k3s commands that use a colon delimiter as well. 2025-11-20 05:00:12 -05:00			- The `scheduler-k3s:cluster-add` command is now `scheduler-k3s:cluster:add`.
			- The `scheduler-k3s:cluster-list` command is now `scheduler-k3s:cluster:list`.
			- The `scheduler-k3s:cluster-remove` command is now `scheduler-k3s:cluster:remove`.
feat: support inline comments for app.json Closes #8007 2025-11-17 00:26:05 -05:00
refactor: remove support for DOKKU_DOCKERFILE_CACHE_BUILD This replicates the docker-options functionality. 2025-11-15 23:27:22 -05:00			`## Removals`

refactor: remove support for DOKKU_DOCKER_BUILD_OPTS This replicates the docker-options functionality. 2025-11-15 23:28:44 -05:00			- Support for the `DOKKU_DOCKERFILE_CACHE_BUILD` environment variable has been removed. Use the `docker-options` plugin to set build arguments for your app instead.
			- Support for the `DOKKU_DOCKER_BUILD_OPTS` environment variable has been removed. Use the `docker-options` plugin to set build arguments for your app instead.
docs: add note on removal of nixpacks no-cache property 2025-11-15 23:31:00 -05:00			- Support for the `no-cache` nixpacks property has been removed. Use the `docker-options` plugin to set build arguments for your app instead.
fix: remove not working method to change the caddy label-key This was never actually used by caddy-docker-proxy so its better to just remove it. 2025-11-16 16:45:56 -05:00			- Support for customizing the label-key for the caddy proxy has been removed. Always use `caddy.` as a prefix for your caddy directives.