whatisgithub

What is replibook?

alexrosbach/replibook — explained in plain English

Analysis updated 2026-05-18

25PythonAudience · ops devopsComplexity · 2/5LicenseSetup · easy

In one sentence

A CLI tool that scans a Linux or macOS server and generates an Ansible playbook to reproduce its setup on another machine.

Mindmap

mindmap
  root((Replibook))
    What it does
      Scans server config
      Generates Ansible playbook
      Matching inventory file
    Tech stack
      Python
      Ansible
      Docker
    Use cases
      Server reproduction
      Migration planning
    Audience
      DevOps engineers
      Sysadmins

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Capture a working server's installed packages, services, and Docker setup as a reusable Ansible playbook.

USE CASE 2

Migrate a manually configured server to a new host without redoing the setup by hand.

USE CASE 3

Document what is actually installed and running on a server for disaster recovery planning.

What is it built with?

PythonAnsibleDockerTyper

How does it compare?

alexrosbach/replibookarlandaren/proagentsaudietoffe/plasma-gpu-router
Stars252525
LanguagePythonPythonPython
Setup difficultyeasyeasyhard
Complexity2/51/53/5
Audienceops devopsvibe coderops devops

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 30min

Review generated playbooks before sharing, they can include sensitive Docker environment variables and host paths.

MIT license: free to use, modify, and distribute, including commercially, as long as the license notice is kept.

So what is it?

Replibook scans a running Linux or macOS server and turns what it finds, installed packages, running services, Docker containers, and Docker Compose deployments, into a ready to run Ansible playbook that can recreate the same setup on another machine. It automatically detects whether it is running on Linux or macOS and uses the right tools for each: apt and dpkg for packages plus systemd for services on Linux, or Homebrew formulas, casks, and Homebrew services on macOS. If a tool like Docker or Homebrew is not present, that part of the scan simply returns nothing rather than failing. You install it with pipx, then run the replibook command, which walks you through an interactive menu explaining what each scan module does, lets you choose where to save the output, and asks whether the resulting inventory should target the local machine or a remote one over SSH. The result is a playbook file and a matching inventory file that you can hand to Ansible directly, or apply through Replibook's own guided apply command, which can also install Ansible and any missing collections it needs first. The README is direct about the tool's limits: generated playbooks can contain sensitive information such as Docker environment variables and file paths specific to the original host, so they should be reviewed before being shared or committed anywhere. Replibook also does not back up actual data: Docker volumes, bind mounted files, databases, uploads, or other application data are not captured, only the configuration needed to reproduce the setup, so real backups still need to be handled separately. The project is organized into a scanner package with one module per scan type, a generator package that assembles scan results into Ansible YAML using Jinja2 templates, and small utility code for detecting the operating system. It requires no elevated privileges on macOS, and on Linux only needs elevated access for reading the Docker socket. It is released under the MIT license.

Copy-paste prompts

Prompt 1
Run Replibook on my server and generate an Ansible playbook including packages, services, and Docker containers.
Prompt 2
Apply this Replibook generated playbook to a new Ubuntu server over SSH and install missing Ansible dependencies.
Prompt 3
Review this generated playbook for sensitive environment variables before I commit it to version control.

Frequently asked questions

What is replibook?

A CLI tool that scans a Linux or macOS server and generates an Ansible playbook to reproduce its setup on another machine.

What language is replibook written in?

Mainly Python. The stack also includes Python, Ansible, Docker.

What license does replibook use?

MIT license: free to use, modify, and distribute, including commercially, as long as the license notice is kept.

How hard is replibook to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is replibook for?

Mainly ops devops.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.