Skip to content

Maintenance mode#1497

Merged
djmb merged 2 commits intomainfrom
maintenance-mode
Apr 17, 2025
Merged

Maintenance mode#1497
djmb merged 2 commits intomainfrom
maintenance-mode

Conversation

@djmb
Copy link
Collaborator

@djmb djmb commented Apr 16, 2025

Adds support for maintenance mode to Kamal.

There are two new commands:

  • kamal app maintenance - puts the app in maintenance mode
  • kamal app live - puts the app back in live mode

In maintenance mode, the kamal proxy will respond to requests with a
503 status code. It will use an error page built into kamal proxy.

You can use your own error page by setting error_pages_path in the
configuration. This will copy any 4xx.html or 5xx.html files from that
page to a volume mounted into the proxy container.

Closes: #162

@djmb djmb force-pushed the maintenance-mode branch 2 times, most recently from 0b129a4 to 161c751 Compare April 16, 2025 12:54
djmb added 2 commits April 17, 2025 09:08
Maps in and external /home/kamal-proxy/.app-config volume that we can
use to map files to the proxy.

Can be used to store custom maintenance pages or SSL certificates.
Adds support for maintenance mode to Kamal.

There are two new commands:
- `kamal app maintenance` - puts the app in maintenance mode
- `kamal app live` - puts the app back in live mode

In maintenance mode, the kamal proxy will respond to requests with a
503 status code. It will use an error page built into kamal proxy.

You can use your own error page by setting `error_pages_path` in the
configuration. This will copy any 4xx.html or 5xx.html files from that
page to a volume mounted into the proxy container.
@djmb djmb force-pushed the maintenance-mode branch from 161c751 to 354530f Compare April 17, 2025 08:11
@djmb djmb merged commit 2a8d561 into main Apr 17, 2025
10 checks passed
@djmb djmb deleted the maintenance-mode branch April 17, 2025 08:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Suggestion: maintenance mode

1 participant