Mafl — a minimalist, self-hosted start page / dashboard configured with a simple YAML file, with service status checks and widgets. Deployed as a single host-networked Nomad service.
Needs nomad-pack on PATH. The script only adds the nomploy registry and runs this pack.
Source ↗ Project ↗ ★ 757 ⚑ Report an issue
Save as values.hcl, edit, then run:
# The name of the Nomad job.
job_name = "mafl"
# The Nomad namespace to deploy into.
namespace = "default"
# The datacenters to deploy to.
datacenters = ["*"]
# The Mafl container image. Pin a tag in production.
image = "ghcr.io/hywax/mafl:latest"
# Host port for the Mafl web UI.
port = 3000
# Named volume mounted at /app/data.
data_volume = "mafl_data"
# Placement constraints. On a nomploy cluster: attribute = "$${meta.nomploy_control_plane}", operator = "=", value = "true".
constraints = []
# The task resources.
resources = {
cpu = 300
memory = 256
}
| Name | Type | Default | Description |
|---|---|---|---|
| job_name | string | "mafl" | The name of the Nomad job. |
| namespace | string | "default" | The Nomad namespace to deploy into. |
| datacenters | list | ["*"] | The datacenters to deploy to. |
| image | string | "ghcr.io/hywax/mafl:latest" | The Mafl container image. Pin a tag in production. |
| port | number | 3000 | Host port for the Mafl web UI. |
| data_volume | string | "mafl_data" | Named volume mounted at /app/data. |
| constraints | list | [] | Placement constraints. On a nomploy cluster: attribute = "$${meta.nomploy_control_plane}", operator = "=", value = "true". |
| resources | object | {
cpu = 300
memory = 256
} | The task resources. |
No variables match.
This pack stores data in one Docker named volume:
mafl_data
restic
# Run on the node hosting this pack. Point restic at your repo first: # export RESTIC_REPOSITORY="s3:https://<account>.r2.cloudflarestorage.com/<bucket>" # export RESTIC_PASSWORD="<repo-password>" # export AWS_ACCESS_KEY_ID=<key> AWS_SECRET_ACCESS_KEY=<secret> restic backup \ /var/lib/docker/volumes/mafl_data/_data
rclone (sync to S3/R2)
rclone sync /var/lib/docker/volumes/mafl_data/_data backup:<bucket>/mafl_data
Paths assume the default Docker volume location (/var/lib/docker/volumes). Restore by stopping the job, restoring files into the same volume, and re-running the pack.
Mafl — a minimalist, self-hosted start page / dashboard configured with a single
config.yml. Group links into sections, show live service status checks, and add small widgets — a clean home page for
your homelab without a heavy admin UI.
Single host-networked Nomad service with a persistent config volume.
nomad-pack registry add nomploy https://github.com/Nomploy/nomad-packs
nomad-pack run mafl --registry=nomploy
| Variable | Default | Description |
|---|---|---|
port |
3000 |
Web UI port (PORT). |
image |
ghcr.io/hywax/mafl:latest |
Container image. Pin a tag in production. |
data_volume |
mafl_data |
/app/data — holds config.yml. |
resources |
{ cpu = 300, memory = 256 } |
Task resources. |
Mafl writes a starter
config.ymlinto the volume on first run — edit it to define your sections, links and checks. A prestart init task makes the data volume writable. Pin the job to the node holding the volume withconstraints.