rostr

CLI-first server inventory management with YAML as the single source of truth

GitHub Documentation

Features

Everything you need to manage your server infrastructure from the command line

YAML Inventory

Simple, readable, version-controllable server inventory files. Your entire infrastructure documented in plain text.

SSH Config

Auto-generates SSH config with proper host entries. Just sync and connect with simple hostnames.

Ansible Inventory

Generate Ansible-compatible inventory files automatically. Groups, variables, and host definitions ready to use.

Fuzzy SSH

Interactive fuzzy-finder for quick server selection. Type a few characters, find your server instantly.

OS Auditing

Track operating system versions across your fleet. Identify outdated systems needing updates.

Git Sync

Auto-commit and push changes to your Git repository. Full version history of every infrastructure change.

Monitoring

Integrated Uptime Kuma support. Automatically create monitoring entries when servers are added.

Cloud-init

Registration API for automated server enrollment. New VMs register themselves on first boot.

Quick Install

Get started in seconds

curl -fsSL https://raw.githubusercontent.com/wnstify/rostr/main/install.sh | bash

Then run: rostr init

Alternative installation methods 
# Install via pipx
pipx install git+https://github.com/wnstify/rostr.git

# Or clone and install manually
git clone https://github.com/wnstify/rostr.git ~/.rostr
cd ~/.rostr
python -m venv venv
source venv/bin/activate
pip install -e .

About

Simon

Simon

Hey! Simon here. I am a cloud infrastructure specialist and the founder of Webnestify. My career has been dedicated to simplifying complex hosting through automation and high-performance server architecture. While I love building systems, I've realized that providing the tools is only half the journey—the other half is empowering others to use them effectively.

Established in Slovakia in 2021, Webnestify is more than a cloud solutions provider. We're your strategic partner in digital transformation. Businesses of all sizes deserve the best technology. We're here to ensure your company doesn't just keep up with the digital age but thrives in it. Join Webnestify and let's redefine success together.

Apply for Exclusive Access

Frequently Asked Questions

Common questions about rostr

What is rostr?
rostr is a CLI-first server inventory management tool that uses YAML as the single source of truth. It automatically generates SSH configs, Ansible inventories, and integrates with monitoring tools like Uptime Kuma.
What operating systems does rostr support?
rostr runs on Linux and macOS. It's designed for Unix-based systems and requires Python 3.12 or higher.
How do I install rostr?
The fastest way is the one-line installer: curl -fsSL https://raw.githubusercontent.com/wnstify/rostr/main/install.sh | bash. You can also install via pipx or clone the repository manually.
Does rostr require a database?
No, rostr uses plain YAML files stored in your filesystem. This makes your inventory human-readable, easy to version control with Git, and portable across systems.
Can rostr integrate with my existing Ansible setup?
Yes, rostr automatically generates Ansible-compatible inventory files. Your server groups, variables, and host definitions are exported in a format Ansible can use directly.
Is rostr free to use?
Yes, rostr is completely free and open source under the MIT license. You can use it for personal and commercial projects without any restrictions.
How does rostr handle multiple server environments?
rostr organizes servers into groups using separate YAML files in the inventory/groups/ directory. You can tag servers and filter by tags, groups, or any custom criteria when running commands.

Related Projects

More tools from Webnestify

server-configs

Production-ready cloud-init templates for rapid server provisioning.

View on GitHub

backupd

Menu-driven backup solution for databases, files, and configurations.

View on GitHub

docker

Docker project templates for common self-hosted applications.

View on GitHub

tubeflow

Research-first YouTube content system for organized video production.

View on GitHub