How do I install Comtrya on macOS or Linux?

Use the provided one-liner: 'curl -fsSL https://get.comtrya.dev | sh'. For specific versions, set VERSION=vx.x.x before sh, as noted in the README.

Comtrya vs Ansible for dotfile management?

Comtrya is simpler and faster for personal, local provisioning due to its lightweight design, while Ansible offers more features for enterprise-scale automation but with greater complexity.

How to create a manifest for installing packages in Comtrya?

Manifests are YAML files that declare packages and configurations; check the documentation at comtrya.dev or the local docs folder for examples and syntax guidelines.

Is Comtrya still maintained or supported?

No, the project is archived as per the README, with no active development or maintainer support, so it's not recommended for new projects needing ongoing updates.

What package managers does Comtrya support?

It supports various package managers through a provider system, but specifics depend on the OS; refer to the documentation for current compatibility and provider details.

Can I run only specific manifests with Comtrya?

Yes, use the -m or --manifests flag with comma-separated names, like 'comtrya apply -m one,two', to target subsets, as shown in the usage examples.

comtrya

Rust

A configuration management tool for automating OS provisioning and dotfiles management on localhost.

Visit Website GitHub

5 stars0 forks0 contributors

What is comtrya?

Comtrya is a configuration management tool built for automating the provisioning of personal operating systems and managing dotfiles. It solves the problem of cumbersome setup when frequently reinstalling OSes by providing a lightweight, purpose-built alternative to enterprise tools. The tool uses manifests to declaratively define packages and configurations, making it easy to reproduce a productive development environment.

Target Audience

Developers who regularly reinstall their operating systems and want a simple, automated way to set up their machines with necessary packages and dotfiles. It's ideal for those frustrated with the overhead of traditional configuration management tools for personal use.

Value Proposition

Developers choose Comtrya because it's specifically designed for localhost provisioning, avoiding the complexity and mismatch of enterprise tools like Ansible or SaltStack. Its manifest-based approach and focus on developer experience make it a streamlined solution for personal automation.

Overview

Configuration Management for Localhost / dotfiles

Use Cases

Best For

Automating setup of a fresh OS install with personal preferences

Related Projects

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub

Managing and syncing dotfiles across multiple machines

Quickly reprovisioning a development environment after OS wipes

Declarative configuration management for localhost without enterprise overhead

Selectively applying subsets of system configurations via manifests

Lightweight alternative to Ansible or Chef for personal use

Not Ideal For

Managing multi-server enterprise infrastructures with complex orchestration needs
Projects requiring active maintenance, community support, and frequent updates
Use cases where advanced package management features like version pinning are essential
Teams needing built-in collaboration tools or deep integration with CI/CD pipelines

Pros & Cons

Pros

Local-First Simplicity

Tailored specifically for personal machine provisioning, avoiding the overcomplexity of enterprise tools like Ansible, making it ideal for developers who frequently reinstall OSes.

Declarative Manifests

Uses YAML-based manifests to define system state declaratively, enabling selective execution via command-line flags for targeted and reproducible setups.

Cross-Platform Support

Supports various package managers through a provider system, allowing provisioning across different operating systems without vendor lock-in.

Dependency Resolution

Leverages petgraph for Directed Acyclic Graph execution, ensuring manifests run in correct order based on dependencies, with plans for concurrency.

Cons

Archived Project

The repository is archived with no active maintainers, meaning no future updates, bug fixes, or security patches, making it risky for long-term use.

Incomplete Features

Key enhancements like async DAG execution and package provider upgrades (e.g., list refresh, version pinning) are only planned, limiting current functionality.

Limited Testing

Admitted to be light on tests in the README, which could result in instability or undiscovered bugs during provisioning runs.

Open Source Alternative To

comtrya is an open-source alternative to the following products:

Chef

Chef is an infrastructure automation platform that uses code to automate how infrastructure is configured, deployed, and managed across network devices and cloud environments.

Ansible

Ansible is an open-source automation platform for configuration management, application deployment, and task automation. It uses YAML-based playbooks to describe automation jobs in a human-readable format.

Puppet

Puppet is an infrastructure automation platform that manages system configuration across servers using declarative code.

SaltStack

SaltStack (now Salt Project) is an infrastructure automation and configuration management tool that uses a master-minion architecture for remote execution and state management.

Frequently Asked Questions

Home

Rust

goose

an open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM

Stars51,561

Forks5,677

Last commit7 hours ago

just

🤖 Just a command runner

Stars34,913

Forks825

Last commit12 hours ago

mise

dev tools, env vars, task runner

Stars31,057

Forks1,283

Last commit6 hours ago

jj

A Git-compatible VCS that is both simple and powerful

Stars30,567

Forks1,146

Last commit6 hours ago

#system-configuration

#package-management

#configuration-management