Enforcing deprecation of legacy app config variables

Scheduled Maintenance Report for Aptible

Completed

The scheduled maintenance has been completed.
Posted Jun 09, 2026 - 12:00 EDT

In progress

Scheduled maintenance is currently in progress. We will provide updates as necessary.
Posted Jun 09, 2026 - 11:00 EDT

Update

We will be undergoing scheduled maintenance during this time.
Posted Jun 01, 2026 - 17:01 EDT

Scheduled

As previously announced, we are completing the migration away from managing endpoint behavior and image deployment details through app environment variables. These settings are now managed as dedicated Endpoint Settings and Image Deployment Settings.

Rollout schedule
• June 1, 2026: Enforcement begins on Shared Stacks.
• June 9, 2026: Enforcement begins on Dedicated Stacks.

What changes
After enforcement begins on a stack, any deploy or configure operation that submits one of the impacted variables below with a value will be rejected with the error "Deprecated environment variable used," and the operation will not complete. This is triggered by what your deploy tooling sends on each operation, not by values already stored on your app, so an outdated CLI or a pre-v5 GitHub deploy action will fail because it resends these variables every time.

Once your tooling no longer sends these variables, your deploys and configures succeed as normal. At that point any of these values still present in your app environment are migrated to the appropriate Endpoint or Image Deployment Settings and removed from the app environment automatically, with no change to how your apps and endpoints behave.

What you need to do
Most users can resolve this by updating their tooling:
• Update the Aptible CLI to v0.26.6 or later: https://www.aptible.com/docs/reference/aptible-cli/overview
• Update the Aptible GitHub Deploy Action to v5: https://github.com/marketplace/actions/deploy-to-aptible
• If you use Terraform, update to the aptible/aptible v0.10.0 provider, which accepts these as parameters on the aptible_endpoint and aptible_app resources: https://github.com/aptible/terraform-provider-aptible/releases/tag/v0.10.0

Impacted variables
APTIBLE_DOCKER_IMAGE, APTIBLE_PRIVATE_REGISTRY_USERNAME, APTIBLE_PRIVATE_REGISTRY_PASSWORD, DISABLE_WEAK_CIPHER_SUITES, FORCE_SSL, IDLE_TIMEOUT, MAINTENANCE_PAGE_URL, RELEASE_HEALTHCHECK_TIMEOUT, SHOW_ELB_HEALTHCHECKS, SSL_CIPHERS_OVERRIDE, SSL_PROTOCOLS_OVERRIDE, STRICT_HEALTH_CHECKS

For background and migration guidance, see:
https://www.aptible.com/changelog/introducing-endpoint-and-image-deployment-settings
https://www.aptible.com/docs/core-concepts/apps/deploying-apps/configuration

If you have questions, contact Aptible Support.
Posted Jun 01, 2026 - 15:58 EDT
This scheduled maintenance affected: Aptible Deploy.