Netgate is offering COVID-19 aid for pfSense software users, learn more.
Launching an Instance¶
Here are instructions on how to launch a new instance of the pfSense® firewall/VPN appliance from the Amazon EC2 Management Console.
Select the region for the instance to run in using the region tab at the upper right corner of the page.
Navigate to the AWS Management Console Main Page and select EC2 under the Compute section in the All services dropdown.
Launch a new instance by clicking on the Launch Instance button under the Create Instance section of the EC2 dashboard.
Select AWS Marketplace in the left-hand Navigation Menu. Type
Netgate pfSensein the search box and press enter.
Click the Select button for the Netgate pfSense Firewall/VPN/Router listing in the search result.
Review pricing and other helpful information, then click Continue.
Choose the instance type to run by clicking the checkbox next to the desired type. Click Next: Configure Instance Details.
Choose the desired Network and Subnet that the instance will be deployed in. Choose any other instance-specific settings that may be required in your environment. Optionally expand the Advanced Details section and set parameters as text in the User Data field. The available options are:
password - setting a value via a directive like
password=abcdefgwill set the password for the administrative account to the value you specify -
abcdefgin this example. If no value is set here, a random password will be assigned in order to keep administrative access from being exposed to the Internet with a default password.
mgmtnet - setting a value via a directive like
mgmtnet=10.0.1.0/24will restrict management access (http, https, ssh) to the network you specify -
10.0.1.0/24in this example. This will cause the firewall rules on the instance (not on Amazon’s access lists, but on the Netgate pfSense appliance’s own firewall) to restrict management traffic for the instance to the specified source network. The default behavior is to allow management from any host.
These directives can be set by placing them on a single line in the User Data field and separating them with colons. To specify both parameters, type a statement similar to this one:
If a password is set using the password parameter listed above, the password is retrieved by the instance via an unencrypted HTTP request when the system is configured the first time it boots. The request is made to an Amazon Web Services-operated server on the local LAN that stores metadata about each instance running. The data for an instance is only made available to that instance, but is available to be queried from the instance without providing any authentication credentials.
It is advised to change the admin password via the pfSense web GUI after the instance comes up to avoid any security risks associated with the unencrypted request. Otherwise it is possible to choose not to set the password at all and let a random password be set.
Choose the desired Network and Subnet to which the Instance will be deployed. Scroll down to configure the network interface(s) with a Static or DHCP-assigned IP address.
Once the Network Interface(s) are configured, select Next: Add Storage.
Click Next: Add Tags to accept the Storage Device Configuration.
It is recommended to set a tag that can be used to differentiate this instance from other instances by entering a value for the Name tag. Click Next: Configure Security Group after setting any desired tags.
Press the Add Tag button. Input
Nameunder the Key field and the desired Instance Tag Name under the Value field (e.g.
Select a security group to launch the instance with. The Security group name and Description can be left at the default, or replaced with the desired values. The recommended settings for a security group should allow at least the following traffic:
TCP port 443 from 0.0.0.0/0
HTTPS - This is the port that the management web GUI listens on.
TCP port 22 from 0.0.0.0/0
SSH - This port can be used to connect to a command prompt with an ssh client.
UDP port 1194 from 0.0.0.0/0
OpenVPN - The OpenVPN server that is configured by default is bound to this port.
UDP port 500 from 0.0.0.0/0
IKE for IPsec VPN.
UDP port 4500 from 0.0.0.0/0
IPsec/NAT-T for IPsec VPN.
If there is an existing security group that includes this access, click Select an existing security group, then select the desired group(s) to use and click Continue. Otherwise, select Create a new security group, and add rules for this access by filling in the form for each rule and clicking the Add Rule button. When all of the rules have been added, click Review and Launch.
Review any AWS warnings and make note of recommendations. Scroll down to review the remaining instance details and click Launch after making any needed adjustments.
Select an existing key pair or create a new key pair to connect to the instance with. Click the checkbox that indicates acknowledgment of access to the selected private key file and then click Launch Instances.
Do NOT select the Proceed Without a Key Pair option.