ansible-server-setup/README.md

Ansible Playbook for Initial Server Setup

This Ansible playbook is intended to be used on all new servers on my local and cloud networks, whether they be a physical box, VM, or VPS.

Features

• Basic security and SSH configuration
• SNMP and RSyslog configuration for use with LibreNMS
• Tailscale enrollment

Goals

• Automate initial server configuration for my homelab and cloud environments
• Ensure that basic security practices are in place accross all servers
• Use consistent SNMP configurations accross all devices while taking advtange of device-specific SNMP plug-ins (Pi-Hole, ZFS, etc.)

Requirements

• Up-to-date Ansible install
• Red Hat or Debian based operating systems on your hosts
• Working LibreNMS install with network access
• Tailscale account and a valid enrollment key

Instructions

While the playbook can target single devices, it was designed to run repeatedly on multiple servers to ensure compliance with the stated goals. If you're not me, you'll probably want to tweak the playbook to your liking, but the below steps should get you going.

1. Clone the repository
2. Add your hosts to the hosts file in the repo (or use your own inventory)
3. Edit the group_vars/all file with your own data. If something doesn't apply to your environment, you can leave it blank.
4. Add your SSH keys to roles/common/files/keys-default. These will be added to the authorized_keys file of each host you target.
5. Run the playbook

   cd ansible-server-setup
   ansible-playbook site.yml -K -i hosts
   

Questions / Feedback

Feel free to open a Github issue or reach out to me on Element - @skoobasteeve:linuxdelta.com.