# rackctl

> The day-0 installer for a nanohype platform — one command takes an empty
> AWS account to a running, self-reconciling platform, then hands off to the
> operator portal for day-2.

rackctl is a thin orchestration engine over `tofu`, `terragrunt`, `kubectl`,
`helm`, `aws`, `git` and `gh`. It drives the real nanohype repos rather than
reimplementing them. Every `init` is a dry-run plan until `--apply` is passed,
and a phase that fails rolls back in reverse.

## Start here

- [Overview](https://docs.rackctl.sh/): The day-0 installer for a nanohype platform — empty AWS account to a running, self-reconciling platform in one command.
- [Install](https://docs.rackctl.sh/install/): Install the rackctl CLI via the install script, Homebrew, or from source — and the tools it shells out to.
- [Quickstart](https://docs.rackctl.sh/quickstart/): From an empty AWS account to a running nanohype platform — write a rackctl.yaml, dry-run, then apply.

## Reference

- [Configuration](https://docs.rackctl.sh/configuration/): The complete rackctl.yaml schema — every field, its type, defaults, and validation rules.
- [Commands](https://docs.rackctl.sh/commands/): Every rackctl subcommand — plan, apply, check, destroy, version — with flags and behavior.
- [The pipeline](https://docs.rackctl.sh/pipeline/): The ordered 0→running bootstrap rackctl walks — ten phases, what each does, and how rollback works.

## Operate

- [Footguns](https://docs.rackctl.sh/footguns/): The sharp edges of a real full-provision — read these before your first apply.
- [Runbook](https://docs.rackctl.sh/runbook/): The calm, ordered way to run a provision — preflight, plan, apply, verify, hand off — plus troubleshooting.

## Source

- [rackctl CLI](https://github.com/rackctl/rackctl): the OSS bootstrapper itself.
- [Documentation source](https://github.com/rackctl/docs): this site.