[SKIP CI] update readme

This commit is contained in:
Drone Shipper 2019-11-23 12:58:32 +00:00
parent 5a74f266b2
commit 607a35f7cd

552
README.md
View File

@ -8,61 +8,61 @@ Setup FreshRSS server
## Table of content ## Table of content
* [Default Variables](#default-variables) * [Default Variables](#default-variables)
* [freshrss_version](#freshrss_version)
* [freshrss_service_directory](#freshrss_service_directory)
* [freshrss_container_name](#freshrss_container_name)
* [freshrss_image](#freshrss_image)
* [freshrss_restart_policy](#freshrss_restart_policy)
* [freshrss_exposed_port](#freshrss_exposed_port)
* [freshrss_exposed_ip](#freshrss_exposed_ip)
* [freshrss_extra_hosts](#freshrss_extra_hosts)
* [freshrss_cap_add](#freshrss_cap_add)
* [freshrss_cap_drop](#freshrss_cap_drop)
* [freshrss_security_opt](#freshrss_security_opt)
* [freshrss_healthcheck](#freshrss_healthcheck)
* [freshrss_default_user](#freshrss_default_user)
* [freshrss_default_password](#freshrss_default_password)
* [freshrss_base_url](#freshrss_base_url)
* [freshrss_language](#freshrss_language)
* [freshrss_title](#freshrss_title)
* [freshrss_allow_anonymous](#freshrss_allow_anonymous) * [freshrss_allow_anonymous](#freshrss_allow_anonymous)
* [freshrss_allow_anonymous_refresh](#freshrss_allow_anonymous_refresh) * [freshrss_allow_anonymous_refresh](#freshrss_allow_anonymous_refresh)
* [freshrss_auth_type](#freshrss_auth_type)
* [freshrss_api_enabled](#freshrss_api_enabled)
* [freshrss_unsafe_autologin_enabled](#freshrss_unsafe_autologin_enabled)
* [freshrss_simplepie_syslog_enabled](#freshrss_simplepie_syslog_enabled)
* [freshrss_pubsubhubbub_enabled](#freshrss_pubsubhubbub_enabled)
* [freshrss_allow_robots](#freshrss_allow_robots)
* [freshrss_allow_referrer](#freshrss_allow_referrer) * [freshrss_allow_referrer](#freshrss_allow_referrer)
* [freshrss_limits_cookie_duration](#freshrss_limits_cookie_duration) * [freshrss_allow_robots](#freshrss_allow_robots)
* [freshrss_limits_cache_duration](#freshrss_limits_cache_duration) * [freshrss_api_enabled](#freshrss_api_enabled)
* [freshrss_limits_timeout](#freshrss_limits_timeout) * [freshrss_auth_type](#freshrss_auth_type)
* [freshrss_limits_max_inactivity](#freshrss_limits_max_inactivity) * [freshrss_base_url](#freshrss_base_url)
* [freshrss_limits_max_feeds](#freshrss_limits_max_feeds) * [freshrss_cap_add](#freshrss_cap_add)
* [freshrss_limits_max_categories](#freshrss_limits_max_categories) * [freshrss_cap_drop](#freshrss_cap_drop)
* [freshrss_limits_max_registrations](#freshrss_limits_max_registrations) * [freshrss_container_name](#freshrss_container_name)
* [freshrss_extensions_enabled](#freshrss_extensions_enabled)
* [ttrss_db_type](#ttrss_db_type)
* [freshrss_db_server](#freshrss_db_server)
* [freshrss_db_port](#freshrss_db_port)
* [freshrss_db_name](#freshrss_db_name)
* [freshrss_db_user](#freshrss_db_user)
* [freshrss_db_password](#freshrss_db_password)
* [freshrss_db_ssl_mode](#freshrss_db_ssl_mode)
* [freshrss_db_ssl_rootcert](#freshrss_db_ssl_rootcert)
* [freshrss_memory_limit](#freshrss_memory_limit)
* [freshrss_memory_reservation](#freshrss_memory_reservation)
* [freshrss_cpu_shares](#freshrss_cpu_shares) * [freshrss_cpu_shares](#freshrss_cpu_shares)
* [freshrss_pids_limit](#freshrss_pids_limit) * [freshrss_curlopt_proxy](#freshrss_curlopt_proxy)
* [freshrss_salt](#freshrss_salt) * [freshrss_curlopt_proxyauth](#freshrss_curlopt_proxyauth)
* [freshrss_meta_description](#freshrss_meta_description) * [freshrss_curlopt_proxyport](#freshrss_curlopt_proxyport)
* [freshrss_curlopt_proxytype](#freshrss_curlopt_proxytype)
* [freshrss_curlopt_proxyuserpwd](#freshrss_curlopt_proxyuserpwd)
* [freshrss_curlopt_ssl_verifyhost](#freshrss_curlopt_ssl_verifyhost) * [freshrss_curlopt_ssl_verifyhost](#freshrss_curlopt_ssl_verifyhost)
* [freshrss_curlopt_ssl_verifypeer](#freshrss_curlopt_ssl_verifypeer) * [freshrss_curlopt_ssl_verifypeer](#freshrss_curlopt_ssl_verifypeer)
* [freshrss_curlopt_proxytype](#freshrss_curlopt_proxytype) * [freshrss_db_name](#freshrss_db_name)
* [freshrss_curlopt_proxy](#freshrss_curlopt_proxy) * [freshrss_db_password](#freshrss_db_password)
* [freshrss_curlopt_proxyport](#freshrss_curlopt_proxyport) * [freshrss_db_port](#freshrss_db_port)
* [freshrss_curlopt_proxyauth](#freshrss_curlopt_proxyauth) * [freshrss_db_server](#freshrss_db_server)
* [freshrss_curlopt_proxyuserpwd](#freshrss_curlopt_proxyuserpwd) * [freshrss_db_ssl_mode](#freshrss_db_ssl_mode)
* [freshrss_db_ssl_rootcert](#freshrss_db_ssl_rootcert)
* [freshrss_db_user](#freshrss_db_user)
* [freshrss_default_password](#freshrss_default_password)
* [freshrss_default_user](#freshrss_default_user)
* [freshrss_exposed_ip](#freshrss_exposed_ip)
* [freshrss_exposed_port](#freshrss_exposed_port)
* [freshrss_extensions_enabled](#freshrss_extensions_enabled)
* [freshrss_extra_hosts](#freshrss_extra_hosts)
* [freshrss_healthcheck](#freshrss_healthcheck)
* [freshrss_image](#freshrss_image)
* [freshrss_language](#freshrss_language)
* [freshrss_limits_cache_duration](#freshrss_limits_cache_duration)
* [freshrss_limits_cookie_duration](#freshrss_limits_cookie_duration)
* [freshrss_limits_max_categories](#freshrss_limits_max_categories)
* [freshrss_limits_max_feeds](#freshrss_limits_max_feeds)
* [freshrss_limits_max_inactivity](#freshrss_limits_max_inactivity)
* [freshrss_limits_max_registrations](#freshrss_limits_max_registrations)
* [freshrss_limits_timeout](#freshrss_limits_timeout)
* [freshrss_memory_limit](#freshrss_memory_limit)
* [freshrss_memory_reservation](#freshrss_memory_reservation)
* [freshrss_meta_description](#freshrss_meta_description)
* [freshrss_pids_limit](#freshrss_pids_limit)
* [freshrss_pubsubhubbub_enabled](#freshrss_pubsubhubbub_enabled)
* [freshrss_restart_policy](#freshrss_restart_policy)
* [freshrss_salt](#freshrss_salt)
* [freshrss_security_opt](#freshrss_security_opt)
* [freshrss_service_directory](#freshrss_service_directory)
* [freshrss_simplepie_syslog_enabled](#freshrss_simplepie_syslog_enabled)
* [freshrss_title](#freshrss_title)
* [freshrss_unsafe_autologin_enabled](#freshrss_unsafe_autologin_enabled)
* [freshrss_version](#freshrss_version)
* [ttrss_db_type](#ttrss_db_type)
* [Dependencies](#dependencies) * [Dependencies](#dependencies)
* [License](#license) * [License](#license)
* [Author](#author) * [Author](#author)
@ -71,68 +71,62 @@ Setup FreshRSS server
## Default Variables ## Default Variables
### freshrss_version ### freshrss_allow_anonymous
#### Default value #### Default value
```YAML ```YAML
freshrss_version: latest freshrss_allow_anonymous: 'false'
``` ```
### freshrss_service_directory ### freshrss_allow_anonymous_refresh
#### Default value #### Default value
```YAML ```YAML
freshrss_service_directory: /var/lib/docker/services/freshrss freshrss_allow_anonymous_refresh: 'false'
``` ```
### freshrss_container_name ### freshrss_allow_referrer
#### Default value #### Default value
```YAML ```YAML
freshrss_container_name: freshrss freshrss_allow_referrer: 'false'
``` ```
### freshrss_image ### freshrss_allow_robots
#### Default value #### Default value
```YAML ```YAML
freshrss_image: xoxys/freshrss:{{ freshrss_version }} freshrss_allow_robots: 'false'
``` ```
### freshrss_restart_policy ### freshrss_api_enabled
#### Default value #### Default value
```YAML ```YAML
freshrss_restart_policy: on-failure freshrss_api_enabled: 'false'
``` ```
### freshrss_exposed_port ### freshrss_auth_type
#### Default value #### Default value
```YAML ```YAML
freshrss_exposed_port: 80 freshrss_auth_type: form
``` ```
### freshrss_exposed_ip ### freshrss_base_url
Specify address of the freshrss instance, used when building absolute urls, e.g. for websub.
#### Default value #### Default value
```YAML ```YAML
freshrss_exposed_ip: 127.0.0.1 freshrss_base_url: http://localhost/
```
### freshrss_extra_hosts
#### Default value
```YAML
freshrss_extra_hosts: []
``` ```
### freshrss_cap_add ### freshrss_cap_add
@ -151,229 +145,82 @@ freshrss_cap_add: []
freshrss_cap_drop: [] freshrss_cap_drop: []
``` ```
### freshrss_security_opt ### freshrss_container_name
#### Default value #### Default value
```YAML ```YAML
freshrss_security_opt: [] freshrss_container_name: freshrss
``` ```
### freshrss_healthcheck ### freshrss_cpu_shares
#### Default value #### Default value
```YAML ```YAML
freshrss_healthcheck: freshrss_cpu_shares: _unset_
test: '["CMD", "/usr/local/bin/healthcheck.sh"]'
interval: 30s
timeout: 5s
retries: 5
``` ```
### freshrss_default_user #### Example usage
#### Default value
```YAML ```YAML
freshrss_default_user: admin freshrss_cpu_shares: '1024'
``` ```
### freshrss_default_password ### freshrss_curlopt_proxy
#### Default value #### Default value
```YAML ```YAML
freshrss_default_password: freshrss freshrss_curlopt_proxy: _unset_
``` ```
### freshrss_base_url ### freshrss_curlopt_proxyauth
Specify address of the freshrss instance, used when building absolute urls, e.g. for websub.
#### Default value #### Default value
```YAML ```YAML
freshrss_base_url: http://localhost/ freshrss_curlopt_proxyauth: _unset_
``` ```
### freshrss_language ### freshrss_curlopt_proxyport
#### Default value #### Default value
```YAML ```YAML
freshrss_language: en freshrss_curlopt_proxyport: _unset_
``` ```
### freshrss_title ### freshrss_curlopt_proxytype
#### Default value #### Default value
```YAML ```YAML
freshrss_title: FreshRSS freshrss_curlopt_proxytype: _unset_
``` ```
### freshrss_allow_anonymous ### freshrss_curlopt_proxyuserpwd
#### Default value #### Default value
```YAML ```YAML
freshrss_allow_anonymous: 'false' freshrss_curlopt_proxyuserpwd: _unset_
``` ```
### freshrss_allow_anonymous_refresh ### freshrss_curlopt_ssl_verifyhost
#### Default value #### Default value
```YAML ```YAML
freshrss_allow_anonymous_refresh: 'false' freshrss_curlopt_ssl_verifyhost: _unset_
``` ```
### freshrss_auth_type ### freshrss_curlopt_ssl_verifypeer
#### Default value #### Default value
```YAML ```YAML
freshrss_auth_type: form freshrss_curlopt_ssl_verifypeer: _unset_
```
### freshrss_api_enabled
#### Default value
```YAML
freshrss_api_enabled: 'false'
```
### freshrss_unsafe_autologin_enabled
#### Default value
```YAML
freshrss_unsafe_autologin_enabled: 'false'
```
### freshrss_simplepie_syslog_enabled
#### Default value
```YAML
freshrss_simplepie_syslog_enabled: 'true'
```
### freshrss_pubsubhubbub_enabled
#### Default value
```YAML
freshrss_pubsubhubbub_enabled: 'false'
```
### freshrss_allow_robots
#### Default value
```YAML
freshrss_allow_robots: 'false'
```
### freshrss_allow_referrer
#### Default value
```YAML
freshrss_allow_referrer: 'false'
```
### freshrss_limits_cookie_duration
#### Default value
```YAML
freshrss_limits_cookie_duration: '2592000'
```
### freshrss_limits_cache_duration
#### Default value
```YAML
freshrss_limits_cache_duration: '800'
```
### freshrss_limits_timeout
#### Default value
```YAML
freshrss_limits_timeout: '15'
```
### freshrss_limits_max_inactivity
#### Default value
```YAML
freshrss_limits_max_inactivity: '10800'
```
### freshrss_limits_max_feeds
#### Default value
```YAML
freshrss_limits_max_feeds: '16384'
```
### freshrss_limits_max_categories
#### Default value
```YAML
freshrss_limits_max_categories: '16384'
```
### freshrss_limits_max_registrations
#### Default value
```YAML
freshrss_limits_max_registrations: '1'
```
### freshrss_extensions_enabled
List of FreshRSS extensions to enable. Extensions must be already installed!
#### Default value
```YAML
freshrss_extensions_enabled:
- Tumblr-GDPR
```
### ttrss_db_type
#### Default value
```YAML
ttrss_db_type: pgsql
```
### freshrss_db_server
#### Default value
```YAML
freshrss_db_server: localhost
```
### freshrss_db_port
#### Default value
```YAML
freshrss_db_port: 5432
``` ```
### freshrss_db_name ### freshrss_db_name
@ -384,14 +231,6 @@ freshrss_db_port: 5432
freshrss_db_name: freshrss freshrss_db_name: freshrss
``` ```
### freshrss_db_user
#### Default value
```YAML
freshrss_db_user: pgfreshrss
```
### freshrss_db_password ### freshrss_db_password
#### Default value #### Default value
@ -400,6 +239,22 @@ freshrss_db_user: pgfreshrss
freshrss_db_password: secure freshrss_db_password: secure
``` ```
### freshrss_db_port
#### Default value
```YAML
freshrss_db_port: 5432
```
### freshrss_db_server
#### Default value
```YAML
freshrss_db_server: localhost
```
### freshrss_db_ssl_mode ### freshrss_db_ssl_mode
This variable is only supported for `pgsql` DB type. This variable is only supported for `pgsql` DB type.
@ -418,6 +273,149 @@ freshrss_db_ssl_mode: disable
freshrss_db_ssl_rootcert: /etc/ssl/certs/ca-certificates.crt freshrss_db_ssl_rootcert: /etc/ssl/certs/ca-certificates.crt
``` ```
### freshrss_db_user
#### Default value
```YAML
freshrss_db_user: pgfreshrss
```
### freshrss_default_password
#### Default value
```YAML
freshrss_default_password: freshrss
```
### freshrss_default_user
#### Default value
```YAML
freshrss_default_user: admin
```
### freshrss_exposed_ip
#### Default value
```YAML
freshrss_exposed_ip: 127.0.0.1
```
### freshrss_exposed_port
#### Default value
```YAML
freshrss_exposed_port: 80
```
### freshrss_extensions_enabled
List of FreshRSS extensions to enable. Extensions must be already installed!
#### Default value
```YAML
freshrss_extensions_enabled:
- Tumblr-GDPR
```
### freshrss_extra_hosts
#### Default value
```YAML
freshrss_extra_hosts: []
```
### freshrss_healthcheck
#### Default value
```YAML
freshrss_healthcheck:
test: '["CMD", "/usr/local/bin/healthcheck.sh"]'
interval: 30s
timeout: 5s
retries: 5
```
### freshrss_image
#### Default value
```YAML
freshrss_image: xoxys/freshrss:{{ freshrss_version }}
```
### freshrss_language
#### Default value
```YAML
freshrss_language: en
```
### freshrss_limits_cache_duration
#### Default value
```YAML
freshrss_limits_cache_duration: '800'
```
### freshrss_limits_cookie_duration
#### Default value
```YAML
freshrss_limits_cookie_duration: '2592000'
```
### freshrss_limits_max_categories
#### Default value
```YAML
freshrss_limits_max_categories: '16384'
```
### freshrss_limits_max_feeds
#### Default value
```YAML
freshrss_limits_max_feeds: '16384'
```
### freshrss_limits_max_inactivity
#### Default value
```YAML
freshrss_limits_max_inactivity: '10800'
```
### freshrss_limits_max_registrations
#### Default value
```YAML
freshrss_limits_max_registrations: '1'
```
### freshrss_limits_timeout
#### Default value
```YAML
freshrss_limits_timeout: '15'
```
### freshrss_memory_limit ### freshrss_memory_limit
#### Default value #### Default value
@ -446,18 +444,12 @@ freshrss_memory_reservation: _unset_
freshrss_memory_reservation: 256m freshrss_memory_reservation: 256m
``` ```
### freshrss_cpu_shares ### freshrss_meta_description
#### Default value #### Default value
```YAML ```YAML
freshrss_cpu_shares: _unset_ freshrss_meta_description: _unset_
```
#### Example usage
```YAML
freshrss_cpu_shares: '1024'
``` ```
### freshrss_pids_limit ### freshrss_pids_limit
@ -468,6 +460,22 @@ freshrss_cpu_shares: '1024'
freshrss_pids_limit: _unset_ freshrss_pids_limit: _unset_
``` ```
### freshrss_pubsubhubbub_enabled
#### Default value
```YAML
freshrss_pubsubhubbub_enabled: 'false'
```
### freshrss_restart_policy
#### Default value
```YAML
freshrss_restart_policy: on-failure
```
### freshrss_salt ### freshrss_salt
Salt is used to make crypto more unique. You can generate your own salt with e.g. `cat /proc/sys/kernel/random/uuid | sha1sum | awk '{print $1}'`. Salt is used to make crypto more unique. You can generate your own salt with e.g. `cat /proc/sys/kernel/random/uuid | sha1sum | awk '{print $1}'`.
@ -478,68 +486,60 @@ Salt is used to make crypto more unique. You can generate your own salt with e.g
freshrss_salt: _unset_ freshrss_salt: _unset_
``` ```
### freshrss_meta_description ### freshrss_security_opt
#### Default value #### Default value
```YAML ```YAML
freshrss_meta_description: _unset_ freshrss_security_opt: []
``` ```
### freshrss_curlopt_ssl_verifyhost ### freshrss_service_directory
#### Default value #### Default value
```YAML ```YAML
freshrss_curlopt_ssl_verifyhost: _unset_ freshrss_service_directory: /var/lib/docker/services/freshrss
``` ```
### freshrss_curlopt_ssl_verifypeer ### freshrss_simplepie_syslog_enabled
#### Default value #### Default value
```YAML ```YAML
freshrss_curlopt_ssl_verifypeer: _unset_ freshrss_simplepie_syslog_enabled: 'true'
``` ```
### freshrss_curlopt_proxytype ### freshrss_title
#### Default value #### Default value
```YAML ```YAML
freshrss_curlopt_proxytype: _unset_ freshrss_title: FreshRSS
``` ```
### freshrss_curlopt_proxy ### freshrss_unsafe_autologin_enabled
#### Default value #### Default value
```YAML ```YAML
freshrss_curlopt_proxy: _unset_ freshrss_unsafe_autologin_enabled: 'false'
``` ```
### freshrss_curlopt_proxyport ### freshrss_version
#### Default value #### Default value
```YAML ```YAML
freshrss_curlopt_proxyport: _unset_ freshrss_version: latest
``` ```
### freshrss_curlopt_proxyauth ### ttrss_db_type
#### Default value #### Default value
```YAML ```YAML
freshrss_curlopt_proxyauth: _unset_ ttrss_db_type: pgsql
```
### freshrss_curlopt_proxyuserpwd
#### Default value
```YAML
freshrss_curlopt_proxyuserpwd: _unset_
``` ```
## Dependencies ## Dependencies