Ansible pfSense Configuration - micahgrinnell/CC-Capstone-Project GitHub Wiki

Overview

The steps that are shown below outline the complete process I took to configure pfSense for a 4 port Protectli device. This guide is for those who want to configure pfSense through the use of Ansible. If this process seems too complicated or complex, I recommend you go back one page or check out the Manual pfSense Configuration guide here.

This guide will not outline how to install or set up Ansible on your own device. There is plenty of documentation out there for those who wish to install or learn more about Ansible. It will be assumed that you have a basic understanding of how playbooks, templates, and ansible inventories function on a Linux device.

Ansible Configuration

There are several basic configurations we want to apply to our pfSense system using Ansible playbooks. Ansible doesn't come with pfSense support installed so the addition of an external module is required. The one I chose to use can be found at this Github link, and I installed it using this command:

ansible-galaxy collection install pfsensible.core

Once it was installed I looked through the available documentation on the GitHub page so I could get a grasp on how the syntax works within Ansible. I suggest you do the same.

Due to time restrictions and scope, I was unable to complete any substantial Ansible playbooks that configure a pfSense machine without failure