Comtrya

Comtrya is a tool to help provision a fresh OS with the packages and configuration (dotfiles) you need to become productive again.

This is better, yes?

Want to learn how to use Comtrya? Check the docs.

Comtrya now also has documentation in the repository located in the docs/ folder. In order to use it, please install mdbook using cargo install mdbook. Navigate to the docs/ directory and run mdbook serve. The documentation will be available through your web browser usually on localhost:3000.

Comtrya was started by @rawkode, who explains why:

I'm a serial OS installer, I wipe the OS on my machines every, approx, 30 days. I've primarily relied on SaltStack to automate this, but I've grown frustrated with the mismatch between configuration management and personal provisioning.

I've also tried Ansible, Chef, Puppet, mgmt, and probably anything else you're about to suggest; they all have a flaw that makes it too cumbersome to adopt for the trivial use-case.

You'll find binaries over on the releases page.

Or use the install script on Linux and macOS:

curl -fsSL https://comtrya.dev/install.sh | sh

or specify VERSION=vx.x.x to pin to a release version

curl -fsSL https://comtrya.dev/install.sh | VERSION=v0.11.0 sh

On Windows (PowerShell):

irm https://comtrya.dev/install.ps1 | iex

With a Rust toolchain installed, you can also build it from crates.io:

cargo install comtrya

If this doesn't work for your OS and architecture, please open an issue and we'll do our best to support it.

# Run all manifests within your current directory
comtrya apply

# --manifests, or -m, will run a subset of your manifests
comtrya apply -m one,two,three

# Run all manifests within a specified directory
comtrya -d ./manifests apply

Licensed under the MIT license.

Comtrya is a free and open project and lives from contributions of the community.

See our Contribution Guide