DeployCLI Reference
eda maintenance
Instant zero-downtime 503 maintenance mode with custom templates and automated edge rewrites
The eda maintenance command group activates and deactivates instant maintenance mode for your applications (alias: eda mm). When enabled, Caddy immediately serves an elegant, responsive HTTP 503 Maintenance page across all custom domains and public tunnels without stopping your containers or dropping connections.
eda maintenance <command> [options]
eda mm <command> [options]
explita deploy maintenance <command> [options]1. Subcommands Overview
| Command | Description |
|---|---|
eda maintenance on [-a <appId>] | Enable instant 503 maintenance mode. |
eda maintenance off [-a <appId>] | Disable maintenance mode and restore traffic routing. |
eda maintenance [status] [-a <appId>] | View current maintenance mode status. |
2. Options
| Flag | Shorthand | Description | Default |
|---|---|---|---|
--app <appId> | -a | Application ID (or auto-resolved from explita.json). | Local project |
--help | -h | Display usage instructions and options. |
3. Usage Examples
# Enable maintenance mode for the current project
eda maintenance on
# Shorthand alias:
eda mm on
# Check active status
eda maintenance status
# Disable maintenance mode once updates or migrations are complete
eda maintenance off4. Custom 503 Templates & System Architecture
- Zero Container Interruption: Your application container and managed databases remain untouched and fully accessible via
eda shandeda exec. You can safely perform database schema migrations while visitors see the maintenance page. - Custom Branding: Drop a custom HTML file into the server's
custom/filesdirectory:- Global fallback:
/opt/explita/deploy/custom/files/503.html - Per-app page:
/opt/explita/deploy/custom/files/<appId>.503.html
- Global fallback:
- Built-In Fallback: If no custom file is found on disk, Explita's responsive built-in dark cyber 503 template is served automatically.
- SEO Safe: Search engine bots receive proper
HTTP 503 Service UnavailablewithRetry-Afterheaders, preserving domain indexing.