Muppy Documentation

Muppy manages infrastructure the way you would manage it by hand, only written down and repeatable. It connects over SSH to the Hosts you enrol, runs Tasks on them, and collects Facts back. Everything else on this site is built on those three objects.

New here? Read Muppy Concepts first — five minutes, and the rest of the site stops being a glossary problem.

Choose your path

• Run servers

  Enrol a Host, run Tasks on it, manage its services, its firewall and its SSH keys.

  Muppy Core

• Run PostgreSQL

  Clusters, backups and restores, replication sets, High Availability, point-in-time recovery.

  PostgreSQL Guides

• Run Odoo applications

  App Definitions, CI/CD from your git pushes, dev / test / staging / production servers, and a browser IDE on each.

  Odizy

• Run Kubernetes

  Clusters, packages and releases, metapackages, and multi-cloud High Availability with Pack8s.

  Muppy K8s

• Ship an app on Manganese

  Pick an App Definition, describe your build in mpy_setup.sh and your processes in services.yml, push.

  App Servers

• Configure the instance

  Users, S3 buckets, credentials, and the notification channels the queues use.

  Configuration

Also here

Muppy Enterprise	Muppy deployed inside your own infrastructure.
OVH Public Cloud	Commissioning and importing OVH instances.
User Guides	Task-sized how-tos: Restic backups, lock monitoring, script-type Tasks.
Muppy Manganese	Designing an mgx, environment variables, plans, sharing a database.

Reading this with an agent

Every page is also served as raw markdown, and the whole site as a single file. See Using This Doc with an AI Agent for the URLs and what to hand your agent.