# fflux Ansible Configuration

This repo contains Ansible configs for the Freifunk Lëtzebuerg infra.

## Files

- `hosts`: contains all of the machines.
  - Careful: a wrongly defined machine can lead to major problems.
- `authorized_keys`: `fflux` user pubkey

## Directories

- `files`: templates for various playbooks
- `initial_server_setup`: initial server setup
- `gateway`: Set up a fflux gateway
- `api`: api.freifunk.lu
- `firmware`: firmware.freifunk.lu

## Guide

### Initial Server Setup

First, add the machine to `hosts` at the top of the file:

```yml
machine-name-here ansible_host=10.20.30.40
```

Note that `machine-name-here` will be the machine's hostname.

Then, put the machine under the `[initial]` group:

```yml
[initial]
machine-name-here ansible_user=root
```

Finally, change the default private SSH key under `[all:vars]` if necessary:

```yml
ansible_ssh_private_key_file=/home/myuser/.ssh/id_ed25519
```

You can now run the playbook:

```bash
fflux@fflux:~/repos/Ansible-Configuration$ ansible-playbook -i hosts initial_server_setup/initial_setup.yml
```

Note that the placement of the repositories might impact the playbook's behaviour, particularly for more advanced setups, incl. web server.