pyinfra Documentation

Welcome to the pyinfra v1 documentation; it is split into two sections - Using pyinfra and Deploy References. If you’re new to pyinfra you should start with the getting started page.


This is the documentation for pyinfra v1, it is highly recommended to use this version!

If you’re upgrading from 0.x see the 0->1 upgrade notes.

Using pyinfra

Getting Started

A quickstart guide introducing the basics of pyinfra. Start here!

Writing Deploys

The definitive guide to writing reusable, committable deploys (think plays/workflows/playbooks).

Using the CLI

The pyinfra CLI is extremely powerful for ad hoc command execution and management.


Connectors allow pyinfra to seamlessly integrate with other tools.

Deploy Reference

Operations Index

A list of all available operations and their arguments, e.g. apt.packages.

Facts Index

A list of all facts pyinfra can gather from hosts, e.g. host.fact.os.

Example Deploys

A set of documented example deploys highlighting common patterns.

Packaging Deploys

How to package, redistribute and share pyinfra deploys with other people.