mattx
/
tilde-ansible
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity
Ansible playbook that sets up a tilde. Made this because I wanted to learn Ansible.
11 Commits 1 Branch 0 Tags 46 KiB
Python 93.5%
Shell 6.5%
Go to file
mattx a94937c54e Update README 2020-09-01 19:17:36 +02:00
library Initial commit 2020-09-01 14:14:08 +02:00
roles Add support for IRC with Oragono 2020-09-01 19:05:23 +02:00
.gitignore Initial commit 2020-09-01 14:14:08 +02:00
README.md Update README 2020-09-01 19:17:36 +02:00
Vagrantfile Initial commit 2020-09-01 14:14:08 +02:00
playbook.yml Add support for IRC with Oragono 2020-09-01 19:05:23 +02:00
vars.yml Add support for IRC with Oragono 2020-09-01 19:05:23 +02:00

README.md

tilde-ansible

An Ansible playbook that I wrote to learn Ansible. It configures any Debian box similarly to a tilde.

Configure

Open vars.yml with your favorite text editor.

Variables are:

  • hostname: Hostname for Postfix and the default index.html (Postfix is set to local only).
  • sysadmin: User to redirect mail for root to. Also shown in the MOTD.
  • registerMail: Optional, email address for manual registration. Used in index.html.
  • mailTemp: Optional, shows that the email is a temporary registration method in index.html.
  • sysadminwhois: Required if IRC role enabled, sets the whois text for the sysadmin after invoking /oper

Deploy

Vagrant

A simple way to try this out is to make a VM with it using Vagrant.

Simply type vagrant up and then vagrant ssh to login.

Bare metal

Warning: It can be quite hard to undo this.

Run ansible-playbook -u USER -i "target" playbook.yml, replacing USER with a user that can run sudo and target with the hostname of your target server.

Post-deployment

Make sure to reload Nginx after deployment.

Roles

Base

The base role contains:

  • Postfix set up for local mail only
  • Nginx with a placeholder page that can tell your email for registration

Games

The games role contains:

  • BSD games
  • A few roguelike games
  • Botany, a command line virtual plant buddy

IRC

The IRC role contains:

  • Oragono IRC daemon, configured to listen on localhost only
  • WeeChat

FAQ

Why did you make this?

To learn Ansible, as stated before.

Can you add x?

If it doesn't have 5 million bugs or security vulnerabilities, sure.

Are there any deployments of this?

No, but please tell me if so.

How can I talk to you?

With IRC on tilde.chat, I'm mattx on there. Or mattx at tilde.team on XMPP.

Is there a 6th FAQ question?

Hmm.