pyinfra Documentation

Welcome to the pyinfra v2 documentation. If you’re new to pyinfra you should start with the Getting Started page.

Using pyinfra

Getting Started
A quickstart guide introducing the basics of pyinfra. Start here!
Using Operations
The guide to writing reusable, committable operations in Python files.
Inventory & Data
Use groups, host, and group data to control and configure operations for any environment.
Global Arguments
Arguments available in all operations & facts such as _sudo, _serial and _env.
Using the CLI
The pyinfra CLI is extremely powerful for ad hoc command execution and management.
Frequently Asked Questions
Quick answers to the most commonly asked questions for using pyinfra.

Deploy Reference

Example Deploys
A set of documented example deploys that focus on common patterns and use-cases.
Connectors Index
A list of connectors to target different hosts such as @docker, @local and @terraform.
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. server.Hostname.

How pyinfra Works

Packaging Deploys
How to package, redistribute and share pyinfra deploys as Python packages.
Writing Connectors
Learn how to write your own connectors for pyinfra.
Writing Operations
Learn how to write your own operations for pyinfra.
Writing Facts
Learn how to write your own facts for pyinfra.
Deploy Execution
Learn how pyinfra executes operations against target hosts.