Self-host Grav on a VPS

A flat-file CMS that stores pages as Markdown files, so there is no database to run. Edit content in the admin panel or directly on the volume.

levelrail-cli templates install grav --name my-grav

Specification

Status
Listed
Category
Applications
Services
grav
Ports
80
Volumes
1
Memory
about 256 MiB
arm64
unknown
amd64
unknown
Settings to fill in
none
Listing
Community template

About Grav

A flat-file CMS that stores pages as Markdown files, so there is no database to run. Edit content in the admin panel or directly on the volume.

What it deploys

Grav runs as one service in a single Compose app, listening on port 80, with 1 named volume mount.

ServiceImageTagPortsVolumes
grav lscr.io/linuxserver/grav 2.2.21-ls293 80 config -> /config

Before you install

  • CPU architecture. arm64 unknown. The scan could not read a manifest or the tag is chosen at install time. This is not a claim either way.
  • Listed. It is in the catalog. Back up the data volume before changing an image tag.

Settings and environment

You do not have to fill in anything. Values are never shown here.

ServiceVariableValue
gravPGIDPreset by the template
gravPUIDPreset by the template
gravTZPreset by the template

First run

  1. Open /admin on the public address and create the first administrator account before anyone else does.

Install Grav on a VPS

  1. Install Levelrail on a fresh VPS

    Run this as root on a Linux server (amd64 or arm64) with ports 80 and 443 reachable. The installer prints a setup link.

    curl -fsSL https://levelrail.com/install.sh | sudo sh
  2. Sign in

    Open the setup link, choose a password, then log the CLI in. The CLI install command is curl -fsSL https://levelrail.com/install-cli.sh | sh if the machine does not have it. See Getting started.

    levelrail-cli login --device
  3. Read the template

    Shows the entry, including its full compose.yaml.

    levelrail-cli templates get grav
  4. Install it

    This template has an install form, so the CLI fills each setting from --env, a generated secret or its default.

    levelrail-cli templates install grav --name my-grav

    To put a service behind a domain at install, add --domain SERVICE=HOST:

    levelrail-cli templates install grav --name my-grav --domain grav=grav.example.com

Without a domain the app gets an sslip.io address. You can also deploy it from the dashboard: Apps, New app, Browse templates, then Grav.

More in Applications

All Applications templates