# iconserver-deploy

A playbook to deploy and manage [iconserver](https://github.com/mat/besticon).

Includes two roles:
* docker
* iconserver

## Docker
Supported operating systems:
* CentOS Stream 9, RHEL 9 and clones
* Ubuntu 24
* Debian 12

Earlier versions and other debian-based distributions may not be compatible.
(Please check [docker documentation](https://docs.docker.com/engine/install/).)

## Iconserver
The service is deployed via docker-compose config. Two services are deployed:
* [iconserver](https://hub.docker.com/r/matthiasluedtke/iconserver)
* [nginx](https://hub.docker.com/_/nginx)

The service is deployed to be available via https using a self-signed certificate.
Nginx configuration template can be edited in the role.

## Deployment

The project deployment has been developed and tested with `ansible-core 2.17.4`.
If you run an earlier version your mileage may vary, but it should be compatible.

To deploy the configuration the target servers have to be able to reach docker
repos and docker hub via internet.

Ansible config and inventory files are included. Update `inventory.yml` to match
your setup.

After that deploying the service is as simple as running:
```bash
ansible-playbook deploy.yml
```
(Add necessary options, like `-u` or `-K` etc.)