# Host

> What a host is and how it is configured.

---

LLMS index: [llms.txt](/llms.txt)

---

> [!TODO]
>
> explain what a host is and how it is configured

A host is a resolved configuration that is produced by this repository. These
can be user home directories, full systems, or a fleet of systems. Individual
hosts are configured under the folder `modules/hosts/<type>/<hostname>`
depending on what type of host they are and the name of the particular host.

An overview of the hosts that have been configured can be found under the
[hosts page](../../hosts/README.md)

## Home Manager Hosts

> [!TODO]
>
> explain best practices for configuring a home manager host

`default.nix` - entry point for the home
`packages/` or `packages.nix` - package entries configured for the user

## NixOS Hosts

> [!TODO]
>
> explain best practices for configuring a NixOS host

`default.nix` - entry point for the host
`configuration.nix` - definitions what a host is supposed to do
`hardware-configuration.nix` - definitions specific to the hardware that the host is currently running on

## Fleet Hosts

> [!TODO]
>
> explain best practices for configuring a fleet host

`default.nix` - entry point for the fleet