Julien Riou
989042f28a
Some checks failed
/ ansible-docsmith (push) Failing after 24s
Signed-off-by: Julien Riou <julien@riou.xyz>
39 lines
897 B
Markdown
39 lines
897 B
Markdown
# Ansible Role Firefly
|
|
|
|
Ansible role to manage a [Firefly III](https://firefly-iii.org/) instance.
|
|
|
|
## Configuration
|
|
|
|
See [Variable
|
|
precedence](https://docs.ansible.com/ansible/latest/playbook_guide/playbooks_variables.html#ansible-variable-precedence)
|
|
to find where you should put your own variables.
|
|
|
|
Then define at least `firefly_static_cron_token`, `firefly_db_password` and
|
|
`firefly_app_key` variables with a strong and secure password, encrypted using
|
|
[ansible-vault](https://docs.ansible.com/ansible/latest/cli/ansible-vault.html).
|
|
|
|
See list of [default variables](defaults/main.yml).
|
|
|
|
|
|
## Usage
|
|
|
|
Example of a basic firefly.yml playbook:
|
|
|
|
```yaml
|
|
hosts:
|
|
- firefly
|
|
|
|
roles:
|
|
- firefly
|
|
```
|
|
|
|
Then run the playbook:
|
|
|
|
```
|
|
ansible-playbook firefly.yml
|
|
```
|
|
|
|
## Donate
|
|
|
|
As we all love FOSS projects, you should consider [sponsoring and/or
|
|
contribute](https://github.com/firefly-iii/firefly-iii).
|