Explita InfraExplita Infra
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

CommandDescription
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

FlagShorthandDescriptionDefault
--app <appId>-aApplication ID (or auto-resolved from explita.json).Local project
--help-hDisplay 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 off

4. Custom 503 Templates & System Architecture

  • Zero Container Interruption: Your application container and managed databases remain untouched and fully accessible via eda sh and eda 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/files directory:
    • Global fallback: /opt/explita/deploy/custom/files/503.html
    • Per-app page: /opt/explita/deploy/custom/files/<appId>.503.html
  • 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 Unavailable with Retry-After headers, preserving domain indexing.

On this page