Ansible playbook for installing Nitter
Go to file
staticsafe d9a925b3f2 update README.md with some docs for playbook 2021-09-11 15:33:52 -04:00
common/tasks add pwgen to deps list and add NITTER_HMAC variable to group_vars/all.sample 2021-09-11 12:55:53 -04:00
group_vars add nitter-nginx role and enable it in site.yml 2021-09-11 14:55:36 -04:00
nim make sure to specify we are templating for clarity in nim/tasks/main.yml and nim/tasks/main.yml 2021-09-11 13:12:15 -04:00
nitter-app set force to yes for git clone in nitter-app/tasks/main.yml 2021-09-11 13:21:42 -04:00
nitter-config fix syntax issue in nitter-config/templates/nitter.conf 2021-09-11 14:24:33 -04:00
nitter-nginx add nginx template and do the setup in nitter-nginx/tasks/main.yml 2021-09-11 15:11:36 -04:00
nitter-systemd add nitter-systemd role and enable it in site.yml 2021-09-11 13:19:40 -04:00
LICENSE Initial commit 2021-09-11 10:37:28 -04:00
README.md update README.md with some docs for playbook 2021-09-11 15:33:52 -04:00
site.yml add nitter-nginx role and enable it in site.yml 2021-09-11 14:55:36 -04:00

README.md

nitter-ansible

Ansible playbook to install nitter

Requirements

  • Latest stable version of Ansible (this was tested with Ansible 2.10.7)
  • A Ubuntu 20.04 LTS server with a public IP
  • A (sub)-domain name for Nitter with a valid A record with aforementioned IP

How To Use

  • Copy group_vars/all.sample to group_vars/all and edit the following variables:
    • NITTER_DOMAIN - your Nitter domain [MANDATORY]
    • NITTER_PORT - the port you want Nitter to run on, you can leave this on 8080 if you are unsure
    • NITTER_HMAC - you can generate a value for this on your Ansible host with pwgen -s 24 1
    • ACME_ACCOUNT_EMAIL - for SSL certificate expiry notices from LE if renewal fails
  • Make a Ansible hosts file that looks like this:
[nitter]
nitter.example.com
  • Run the playbook with ansible-playbook -i hosts site.yml