Deployment Reference

Up in 30 Seconds.

One file. Any server. Apache or Nginx. Shared hosting or a bare VPS. This page has everything you need — bookmark it and come back whenever you spin up a new site.

Quickstart

# 1. Upload the file

scp index.php user@host:public_html/

# 2. Visit your domain

https://yourdomain.com

# 3. Done

Setup wizard launches automatically

5-Step Quickstart

From a blank server to a live, production-ready site. No prior configuration required.

1

Upload index.php to your web host

FTP, SFTP, SCP, your host's file manager — any method works. Place the file in your public_html/ or document root directory. No other files needed.

2

Visit yourdomain.com in your browser

On the very first request, MonolithCMS creates everything it needs. site.sqlite is created and all 29 database migrations run instantly. A .htaccess file is written to disk, blocking direct browser access to sensitive file types. Cache directories are created. The setup wizard launches.

3

Complete the 4-step setup wizard

Set your site name, create your admin account, configure your AI provider (OpenAI, Anthropic Claude, or Google Gemini), and optionally configure your email sender. Takes under two minutes.

4

Your site is live

The public-facing site is live at your domain. Log in to the admin panel at /admin to start building content, run the AI site generator, or configure settings.

5

Generate your site with AI (optional)

Describe your project in plain language. The AI designs your full site from first principles — colour palette, typography, page structure, all content — and shows you a complete preview before writing a single character to the live database.

Apache vs Nginx Configuration

MonolithCMS runs on both. Here is everything you need to configure each server correctly.

What happens automatically on first request

  • check_circle.htaccess is written to disk, blocking .sqlite, .db, .env, .log, .sh, .bak, and .sql files
  • check_circlemod_rewrite rules written so all requests route through index.php
  • check_circleNo manual .htaccess editing required — ever

Apache requirement

mod_rewrite must be enabled and AllowOverride All must be set for the document root. On cPanel, Plesk, and most shared hosts this is already the default.

Generated .htaccess (written on first request)

RewriteEngine On
RewriteBase /

# Redirect www to non-www
RewriteCond %{HTTP_HOST} ^www\.(.+)$ [NC]
RewriteRule ^ https://%1%{REQUEST_URI} [R=301,L]

# Block direct access to sensitive files
<FilesMatch "\.(sqlite|sqlite3|db|env|log|sh|bak|sql)$">
    Require all denied
</FilesMatch>

Two-File Migration

Moving a MonolithCMS site is two copy commands. Every page, blog post, media file reference, user account, revision, setting, and configuration — all of it lives in site.sqlite. Copy the two files and the entire site is running on the new server.

check_circleStaging to production handoff
check_circleClient server delivery
check_circleHost migration with zero downtime risk
check_circleLocal development ↔ live sync
check_circleInstant full site backup

Terminal — migrate to new server

# Copy the application

cp index.php   new-server/public_html/

# Copy the entire database (site, users, content)

cp site.sqlite new-server/public_html/

✔ That's it. Visit the new domain. Site is live.

Security — Automatic by Default

Every security layer described here requires zero configuration. It is all on by default, from the first request.

shield

Database Protected on All Servers

Auto-generated .htaccess on Apache. PHP-level 403 on Nginx — fires before any routing logic. The database is unreachable even if the web server is misconfigured.

lock

bcrypt Cost 12 + HMAC CSRF

Passwords hashed with bcrypt at cost 12. CSRF tokens derived via HMAC-SHA-256, verified with constant-time comparison, never stored in a database or session.

speed

Rate Limiting on All Inputs

IP-based rate limiting on login (5 attempts per 15 minutes) and contact form submissions (5 attempts per hour). Enforced at the application layer with no external dependency.

verified

Email MFA — 10-Minute Codes

6-digit MFA codes, bcrypt-hashed in the database, expiring in 10 minutes. Per-request Content Security Policy nonces for inline scripts.

storage

Sessions in SQLite

Sessions stored in SQLite rather than the filesystem. Portable across shared hosting environments where /tmp is shared or unreliable across requests.

groups

Role-Based Access Control

Three roles built in: admin, editor, and viewer. Assign clients editor access for content updates while protecting structural settings and deployment controls.

Hosting Compatibility

If it runs PHP 8.1+ and has a writable document root, MonolithCMS runs on it. Here is what you need — and nothing more.

Shared Hosting

cPanel, Plesk, DirectAdmin — any shared host with PHP 8.1+. Upload via the file manager or FTP. .htaccess written automatically. SQLite is bundled with PHP; no database provisioning needed.

Required: PHP 8.1+, mod_rewrite, writable directory

VPS / Dedicated (Apache)

Deploy with SCP or rsync. Ensure AllowOverride All is set for the document root so the auto-generated .htaccess takes effect immediately.

Required: Apache 2.4+, mod_rewrite, AllowOverride All

VPS / Dedicated (Nginx)

Add the two location blocks from the config section above to your server block. PHP-level protection handles what .htaccess would normally cover.

Required: Nginx, PHP-FPM 8.1+, writable directory

MonolithCMS

One file. Any host. Any site.

~18,629 lines of PHP. 29 database migrations on first boot. Zero dependencies. Everything you just read — routing, auth, caching, AI generation, the admin panel — is in a single file you can upload right now. Open source under the GNU General Public License v3.

Get MonolithCMS on GitHubView live AI-built examples →

GNU GPL v3 — self-hosting fully permitted, no phone-home, no cloud dependency of any kind.