Analytics cookies only (Google Analytics, PostHog). No ad networks, no cross-site tracking. See our privacy policy.
A flat-file CMS written in PHP. Pages are Markdown files with YAML front matter in folders on disk, rendered through Twig templates and themes, so there is no database to run. Plugins and themes extend it, and the Admin plugin (bundled in this image) adds a web editor, user accounts, plugin management and backups. Page content, configuration and accounts are plain files under the user folder. The image used here is the community LinuxServer.io build, which packages the grav-admin release with nginx and PHP-FPM. On first visit the site redirects to the admin panel to create the first administrator.
Runs on a VPS from $4/mo (Kamatera 1GB, 1 GB RAM) · prices checked Nov 2026
Fits home hardware (54 MB measured idle, RAM only): Raspberry Pi 4 (4 GB) (arm64 untested), Raspberry Pi 5 (8 GB) (arm64 untested), Repurposed laptop (8 GB), Intel N100 mini PC (16 GB), AMD Ryzen mini PC (32 GB).
Pick Grav when you want a website or blog whose content is Markdown files in folders rather than rows in a database, with Twig themes, a plugin ecosystem and an optional web admin panel for editors. Backing up the site is copying a directory and moving it is a file copy. It is MIT-licensed (the repository's licence file is the MIT text), PHP 8.3 or newer, and needs no database server. Be clear about the image: the one we use is the LinuxServer.io community build `lscr.io/linuxserver/grav`, not an image from the Grav project, and it downloads the `grav-admin` release into the image and includes the Admin plugin. Our snippet adapts that image's README compose example, pins `2.2.28-ls295` (pushed 2026-11-08; Grav 2.2.28 was released 2026-11-07) instead of `latest`, publishes port 8080 and keeps `/config` in a named volume. Choose a database-backed CMS such as WordPress or Ghost instead if you need many concurrent editors, built-in comments or a large plugin marketplace for commerce.
Paid link — we earn a commission if you shop through it.
Run these commands on your server:
# Grav — flat-file CMS with the Admin plugin — community LinuxServer.io image (not published by the Grav project), pinned to 2.2.28-ls295; adapted from the image README's compose example with a named volume for /config and PUID/PGID 1000
cat > docker-compose.yml <<'EOF'
services:
grav:
image: lscr.io/linuxserver/grav:2.2.28-ls295
restart: unless-stopped
environment:
- PUID=1000
- PGID=1000
- TZ=Etc/UTC
ports:
- "8080:80"
volumes:
- grav-config:/config
volumes:
grav-config:
EOF
docker compose up -d
timeout 180 bash -c 'until curl -fsSL -o /dev/null http://localhost:8080/; do sleep 3; done'
# → http://SERVER_IP:8080 — with no users yet, Grav redirects to /admin and shows a form to create the first administrator account (there is no default login)The LinuxServer.io image README, Grav's repository and the Admin plugin flag these before you rely on it:
Grav used 54 MB of RAM at idle on GCP e2-standard-2 · Ubuntu 26.04 LTS · Docker 29.9.3 (first boot, measured Nov 2026). We list a minimum of 256 MB.
The Grav install snippet is marked verified on Ubuntu 26.04 (Nov 2026).