ansible-role-strfry/README.md

1.8 KiB

Ansible Role: strfry

This Ansible Role builds and installs strfry, and also sets up strfry-policies. It is intended to be composed with a separate role to handle the web proxy configuration.

Tested on:

  • Archlinux
  • Debian 11
  • Ubuntu 22.04

Requirements

None.

Role Variables

strfry_version: beta # git repository branch or release tag
strfry_make_jobs: "{{ ansible_processor_cores }}" # number of CPUs to build with
strfry_skip_config: no
strfry_policies_enabled: yes

See the role defaults.

If you are not using the beta branch/version, you should override the template with your own by enabling strfry_skip_config and managing the configuration manually.

strfry_skip_config: yes

For more configuration info, see the relevant upstream configuration example for your branch/version.

Example Playbook

- hosts: strfry
  become: yes
  roles:
    - role: bleetube.strfry
    - role: nginxinc.nginx_core.nginx
  tasks:
    - import_tasks: nginx_conf.yml

A sample nginx configuration is provided.

For a fully functional production example that includes hosting multiple relays, see this homelab stack.

Troubleshooting

If make fails, try building on a single core:

ansible-playbook playbooks/strfry/main.yml -e 'strfry_make_jobs=1'

Logs

systemctl status strfry
journalctl -fu strfry

Resources

Plugins: