Last modified at 4/29/2016 4:49 PM by Koen Zomers

​It is possible to customize the pfSense Captive Portal login page so a custom page will be shown. In order to do this, follow the steps below. This article assumes you already have the captive portal functionality configured and working and just want to change the page that is shown when users access your site. For more information on how to set the captive portal up, check out this video tutorial. It is from an older pfSense version, but the main steps are still the same.

  1. Log in to your pfSense environment
  2. Navigate via the Services menu at the top to Captive Portal

  3. Click on the icon with the E next to the captive portal zone that you wish to modify
  4. Scroll all the way down to nearly the bottom where you'll find the following section. You can create a page in HTML yourself and then upload it to pfSense in the Captive Portal settings page.


A simple sample customized login page allowing both an username/password combination and a voucher can be downloaded here and will look like:


Another simple example which can be used in conjunction with free internet access (thus not allowing any way of authentication):



pfSense up to 2.2
pfSense 2.3 and up

Both are optimized for mobile device displaying. You can easily use it as a starter and customize it to your own liking.

Thanks to Alessandro Agazzi for making me aware of the required changes for pfSense 2.3!