PHPackages                             altis/maintenance-mode - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. altis/maintenance-mode

ActivePackage[Utility & Helpers](/categories/utility)

altis/maintenance-mode
======================

Maintenance mode for Altis, controlled by Altis variables.

00PHP

Since Sep 5Pushed 8mo agoCompare

[ Source](https://github.com/humanmade/altis-maintenance-mode)[ Packagist](https://packagist.org/packages/altis/maintenance-mode)[ RSS](/packages/altis-maintenance-mode/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

Altis Maintenance Mode
======================

[](#altis-maintenance-mode)

A WordPress maintenance mode module for Altis that displays a user-friendly maintenance page when your site is under maintenance, controlled via Altis environment variables.

[![](./screenshot.png)](./screenshot.png)

Why?
----

[](#why)

WordPress' built-in maintenance mode isn't compatible with multi-server architecture like Altis, since it writes out to a `.maintenance` file.

However, there are times where you might still need to enable it - upgrading the database, rolling out substantial changes, or performing imports.

This package adds a maintenance mode which can be controlled through an [Altis Dashboard variable](https://docs.altis-dxp.com/cloud/variables-secrets/).

This maintenance mode runs before the WordPress database loads, allowing you to perform invasive maintenance on the database including full downtime if needed.

Installation
------------

[](#installation)

We're working on adding this to Altis natively.

In the meantime, you can add it by adding this package to your site:

```
composer require altis/maintenance-mode
```

Usage
-----

[](#usage)

1. Navigate to the [Altis Dashboard](https://dashboard.altis-dxp.com/)
2. Select your environment
3. Go to **Settings** → **Variables**
4. Add a new variable:
    - **Name**: `MAINTENANCE_MODE`
    - **Value**: `true`

Then, deploy your site to update the variables. The maintenance page will be displayed across your entire site.

The login form, admin, and CLI are unaffected by maintenance mode, enabling you to continue administrative tasks if needed.

###  Health Score

16

—

LowBetter than 5% of packages

Maintenance43

Moderate activity, may be stable

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity13

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/21655?v=4)[Ryan McCue](/maintainers/rmccue)[@rmccue](https://github.com/rmccue)

---

Top Contributors

[![rmccue](https://avatars.githubusercontent.com/u/21655?v=4)](https://github.com/rmccue "rmccue (1 commits)")

### Embed Badge

![Health badge](/badges/altis-maintenance-mode/health.svg)

```
[![Health](https://phpackages.com/badges/altis-maintenance-mode/health.svg)](https://phpackages.com/packages/altis-maintenance-mode)
```

###  Alternatives

[predaddy/predaddy

Common DDD classes and utilities

16826.5k1](/packages/predaddy-predaddy)[btccom/bitwasp-bitcoin-bch-addon

Bridge to bitwasp/bitcoin for bch.

104.1k1](/packages/btccom-bitwasp-bitcoin-bch-addon)[windinternet/randomdata

TYPO3 extensions to generate new random data or replace existing data with random data

141.4k](/packages/windinternet-randomdata)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)