Kharec/ansible-role-freshrss
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: one uniq example and a table for variables

Browse Source
This commit is contained in:
Sandro CURY CAZZANIGA
2025-11-16 16:17:17 +01:00
parent 835a46ae27
commit 762246f879
1 changed files with 17 additions and 17 deletions
Download Patch File Download Diff File Expand all files Collapse all files

34
README.md
View File

@@ -2,33 +2,33 @@
This role deploys [FreshRSS](https://www.freshrss.org/) to your server(s). This role deploys [FreshRSS](https://www.freshrss.org/) 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. It **does not** deploy php, nor a webserver or a database.
## Example playbook However, it does install the PHP dependencies for FreshRSS, including php-sqlite3 in case you want to use a simple SQLite database.
## Playbook example
```yaml ```yaml
---
- name: Deploy FreshRSS - name: Deploy FreshRSS
hosts: freshrss hosts: freshrss_servers
become: true become: true
vars:
freshrss_root_dir: "/var/www"
freshrss_version: "1.27.1"
freshrss_refresh_interval: 15
roles: roles:
- freshrss - freshrss
``` ```
## Example var file ## Variables:
```yaml | Variable | Default | Required | Description |
freshrss_root_dir: "/var/www" | --------------------------- | ---------------------------------- | -------- | ---------------------------------------------------------------- |
freshrss_version: "1.27.1" | `freshrss_root_dir` | - | **Yes** | Directory where FreshRSS archive is downloaded and extracted |
freshrss_refresh_interval: 15 | `freshrss_path` | `{{ freshrss_root_dir }}/freshrss` | No | 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) |
Variables:
- `freshrss_root_dir`: Directory where FreshRSS archive is downloaded and extracted (required)
- `freshrss_path`: Web-accessible path where FreshRSS will be symlinked (defaults to `{{ freshrss_root_dir }}/freshrss`)
- `freshrss_version`: FreshRSS version to deploy (e.g., "1.27.1")
- `freshrss_refresh_interval`: Feed refresh interval in minutes (e.g., 15 = every 15 minutes)
## FreshRSS configuration ## FreshRSS configuration