aboutsummaryrefslogtreecommitdiffstats
path: root/roles/nitter/README.md
blob: d9d83ae853e932d1be45a9932ae8149888149f37 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
Nitter
======

Description
-----------

The `gathio` role installs and configures [Nitter](https://github.com/zedeus/nitter),
an open source Twitter frontend.

This role configures the application only; it does not configure a reverse proxy.


Variables
---------

This role **accepts** the following variables:

Variable                       | Default              | Description
-------------------------------|----------------------|------------
`nitter_version`               | `master`             | Git version to install
`nitter_server_name`           | `{{ ansible_fqdn }}` | Canonical HTTP hostname
`nitter_port`                  | 8080                 | Local listening port
`nitter_update_on_calendar`    | `weekly`             | Systemd [calendar interval](https://www.freedesktop.org/software/systemd/man/systemd.time.html#Calendar%20Events) for updating Nitter
`nitter_hmac_key`              |                 | Random key for cryptographic signing of video URLs
`nitter_max_connections`       | 100                  | Maximum number of HTTP connections
`nitter_token_count`           | 10                   | Minimum number of API tokens
`nitter_cache_list_minutes`    | 240                  | List cache duration (minutes)
`nitter_cache_rss_minutes`     | 10                   | RSS cache duration (minutes)
`nitter_redis_port`            | 6379                 | Port for local redis instance
`nitter_redis_connections`     | 20                   | Redis connection pool size
`nitter_redis_max_connections` | 30                   | Maximum number of open redis connections

This role **exports** the following variables:

Variable               | Description
-----------------------|------------
`nitter_apache_config` | Apache config block to configure a reverse proxy

Usage
-----

Example playbook:

````yaml
- hosts: nitter_servers
  roles:
    - role: nitter

    - role: apache_vhost
      apache_server_name: '{{ nitter_server_name }}'
      apache_server_aliases: []
      apache_config: '{{ nitter_apache_config }}'
````