# base

Host baseline for the Digitalboard platform. Installs Docker (engine,
CLI, containerd, buildx, compose plugin) and a small set of apt and
convenience packages on Debian/Ubuntu, and sets the shared directory
layout every other role builds on.

This role is intended to run first on every host, before any
service role.

## What it does

- Installs Docker prerequisites (`apt-transport-https`, `ca-certificates`,
  `curl`, `gnupg`, `lsb-release`, `apache2-utils` for `htpasswd`) plus
  convenience packages (`htop`, `ncdu`, `vim`) and Docker itself
  (`docker-ce`, `docker-ce-cli`, `containerd.io`, `docker-buildx-plugin`,
  `docker-compose-plugin`).
- Optionally configures Docker registry mirrors via `/etc/docker/daemon.json`.
- Starts and enables the Docker service and writes a custom `/etc/motd`.

This role defines the shared directory-layout variables
(`docker_compose_base_dir`, `docker_volume_base_dir`) that every service
role consumes, but the per-service subdirectories are created by the
respective service roles, not here.

## Role variables

| Variable | Default | Description |
| --- | --- | --- |
| `docker_compose_base_dir` | `/etc/docker/compose` | Root directory for per-service Compose projects. |
| `docker_volume_base_dir` | `/srv/data` | Root directory for per-service persistent volumes. |
| `docker_registry_mirrors` | `[]` | Optional list of registry mirror URLs; empty disables mirrors. |

## Example

```yaml
- hosts: all
  become: true
  roles:
    - digitalboard.core.base
```

## License

MIT-0