# Choria Configuration Manager


> CCM is a small-scale Configuration Management system designed to meet users where they are - enabling experimentation, R&D, and exploration without the overhead of full-system management while still following sound Configuration Management principles. We focus on great UX, immediate feedback, and interactive use with minimal friction.

## Key Information

- [Resources](https://choria-cm.dev/resources/index.md): Introduction to resources and common properties
- [Hierarchical Data](https://choria-cm.dev/hiera/index.md): Introduce a new take on the well-known hiera tool
- [Data](https://choria-cm.dev/templates/index.md): How to use templates in CCM Manifests and CLI
- [Shell Usage](https://choria-cm.dev/cli/index.md): How to use the ccm CLI tooling
- [YAML Manifests](https://choria-cm.dev/yamlmanifests/index.md): Writing, Hosting and Executing YAML Manifests
- [Agent](https://choria-cm.dev/agent/index.md): Introduces a method for automatically running manifests on a schedule
- [Monitoring](https://choria-cm.dev/monitoring/index.md): Integrating deep health knowledge into resources
- [Design Documents](https://choria-cm.dev/design/index.md): LLM generated design documents for resources


## Resource Reference

- [Archive](https://choria-cm.dev/resources/archive/index.md): Download, extract and copy files from tar.gz and zip archives
- [Exec](https://choria-cm.dev/resources/exec/index.md): Idempotent command execution
- [File](https://choria-cm.dev/resources/file/index.md): Manage files content, ownership and more
- [Package](https://choria-cm.dev/resources/package/index.md): Install, upgrade, downgrade and remove packages using OS Native packagers
- [Scaffold](https://choria-cm.dev/resources/scaffold/index.md): Render template directories into target directories with synchronization and purge support
- [Service](https://choria-cm.dev/resources/service/index.md): Enable, disable, start, stop and restart services using OS Native service managers


## Extendibility and Integration

 - [Shell JSON API](https://choria-cm.dev/cli/api/index.md): Integration point to allow other languages to use ccm resources and types via a STDIN->STDOUT JSON API
 - [CLI Plugins](https://choria-cm.dev/cli/plugins/index.md): Extend the `ccm` command with new sub commands and capabilities

## JSON Schemas

### YAML Manifest

 - [manifest.json](https://choria-cm.dev/schemas/v1/manifest.json): Schema for manifest.yaml

### Shell JSON API

 - [resource_ensure_request.json](https://choria-cm.dev/schemas/v1/resource_ensure_request.json): Request schema for the Shell JSON API
 - [resource_ensure_response.json](https://choria-cm.dev/schemas/v1/resource_ensure_response.json): Response schema for the Shell JSON API