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

The site follows the menus. Muppy documents the screens of the Muppy menus, Manganese those of the Manganese menu, and each section carries the name of the menu it documents.

• Run servers

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

  Muppy ▸ Hosts

• Run PostgreSQL

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

  Muppy ▸ Databases ▸ PostgreSQL

• 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.

  Manganese

• Configure the instance

  Templates, users, server types and S3 buckets.

  Muppy ▸ Configuration

Also here

Muppy Enterprise	Muppy deployed inside your own infrastructure.
OVH Public Cloud	Commissioning and importing OVH instances, under Muppy ▸ Hosts ▸ Provisioning.

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.