Files
ansible-role-freshrss/README.md
2025-11-16 17:45:39 +01:00

2.0 KiB
Raw Blame History

ansible-role-freshrss

This role deploys FreshRSS to your server(s).

It does not deploy php, nor a webserver or a database.

However, it does install the PHP dependencies for FreshRSS, including php-sqlite3 in case you want to use a simple SQLite database.

Requirements

  • Ansible 2.10
  • Deb-based distribution (Debian, Ubuntu, etc.)

Dependencies

This role doesn't have any dependencies to other roles.

Playbook example

---
- name: Deploy FreshRSS
  hosts: freshrss_servers
  become: true
  vars:
    freshrss_root_dir: "/var/www"
    freshrss_version: "1.27.1"
    freshrss_refresh_interval: 15
  roles:
    - freshrss

Variables

Variable Required Default Description
freshrss_root_dir Yes - Directory where FreshRSS archive is downloaded and extracted
freshrss_path No {{ freshrss_root_dir }}/freshrss Web-accessible path where FreshRSS will be symlinked
freshrss_version Yes - FreshRSS version to deploy (e.g., "1.27.1")
freshrss_refresh_interval Yes - Feed refresh interval in minutes (e.g., 15 = every 15 minutes)
freshrss_checksum No "" SHA256 checksum to verify the archive if user sets it

Additional information

FreshRSS configuration is to be done once deployed.

Navigate to the address youve installed your server to complete the installation from the GUI.

License

This project is licensed under the GNU General Public License v3.0 or later (GPLv3+). See the LICENSE file for details.