Getting Started

Prepare pfSense, install pfSense Actions with Docker or Node.js, serve it over HTTPS, and upgrade an existing v1.3.1 deployment.

Prepare pfSense

Turn on SSH in pfSense, give an account shell access and an authorized SSH key, and confirm it can run the commands pfSense Actions uses.

Install with Docker

Build and start pfSense Actions with Docker Compose, create the administrator account with the setup code from the log, connect pfSense, and create a token.

HTTPS Reverse Proxy

Put pfSense Actions behind an HTTPS reverse proxy on the Docker host, with forwarded headers read from private addresses and passkeys tied to the hostname.

Run with Node.js

Run pfSense Actions from source with Node.js 24, start it with the development or production scripts, and create the administrator account with the setup code.

Upgrade from v1.3.1

Move a pfSense Actions v1.3.1 deployment to 2.0.0, set it up in the console with a one-time code, and give each client its own personal access token.