# pfBlockerNG > pfBlockerNG is a free, open-source (Apache-2.0) package for pfSense CE and Plus. It turns IP and domain feeds into firewall and DNS policy: IP blocklists become pf aliases and rules, GeoIP permits or denies by country (MaxMind GeoLite2), and DNSBL blocks ads, trackers and malware domains inside the Unbound resolver. Latest stable release: v3.3.14 (2026-11-06). Created by BBcan177, who designs, supports and maintains it with André Brait. Install it from the project package repository at https://pkg.pfblockerng.com/. ## User guide - [Introduction](https://pfblockerng.com/guide/introduction/): What pfBlockerNG is designed to do, where it integrates with pfSense, and which component to configure first. - [Installation](https://pfblockerng.com/guide/installation/): Install pfBlockerNG from the official project package repository before configuring policy. - [General setup](https://pfblockerng.com/guide/general-setup/): Establish safe defaults, apply the first configuration, and verify enforcement after installation. - [Setting up lists](https://pfblockerng.com/guide/setting-up-lists/): Create feed groups, choose actions and schedules, apply changes, and avoid stale or over-broad policy. - [IP blocking](https://pfblockerng.com/guide/ip-blocking/): How IP feeds become pfSense aliases and rules, what action and direction mean, and where suppression and GeoIP fit. - [DNSBL](https://pfblockerng.com/guide/dnsbl/): How DNSBL evaluates domain feeds in Unbound, chooses a response, resolves exceptions, and reports blocked queries. - [Operations](https://pfblockerng.com/guide/operations/): Apply updates, verify policy, investigate events, manage exceptions, and keep package channels current. ## FAQ - [How do I install pfBlockerNG?](https://pfblockerng.com/faq/#install): Run the one-line installer from pkg.pfblockerng.com over SSH as root; it detects your pfSense edition and version. It may also be available in System › Package Manager. The UI lives under Firewall › pfBlockerNG. - [Which channel should I choose?](https://pfblockerng.com/faq/#channels): Stable, unless you want prereleases. Testing validates the next stable, Edge opens the next release family and Nightly is rebuilt from the development tip. A firewall subscribes to exactly one channel. - [Will the setup wizard overwrite my settings?](https://pfblockerng.com/faq/#wizard-overwrite): Yes. The wizard builds an entry-level IP and DNSBL setup, and if pfBlockerNG was configured before, all settings are wiped when it finishes. Skip it if you already have a configuration. - [How do I upgrade?](https://pfblockerng.com/faq/#upgrade): The Software tab shows your channel and version against the latest and can install updates. A daily check raises one notification per new version. Back up the pfSense config before moving to an older version. - [Why does a listed domain still resolve?](https://pfblockerng.com/faq/#domain-still-resolves): Make sure the client actually queries pfSense Unbound: external or encrypted DNS, VPN resolvers and browser secure DNS bypass it. Then look for a higher-priority allow (feed exception, whitelist, TOP1M, temporary unlock) and apply pending changes. - [Does DNSBL block every encrypted DNS service?](https://pfblockerng.com/faq/#encrypted-dns): No. DNSBL only sees queries that reach Unbound. pfBlockerNG can help manage known encrypted-DNS endpoints, but enforce DNS policy with deliberate firewall and device configuration too. - [Do DNSBL updates interrupt DNS?](https://pfblockerng.com/faq/#dnsbl-updates): No. Updates swap the new blocklist into the running resolver without restarting Unbound, so queries keep flowing. - [Why are no IP rules visible?](https://pfblockerng.com/faq/#no-ip-rules): Check that pfBlockerNG is enabled on General, the group and a source are enabled, the action is Deny, Permit or Match (Alias actions create no rules), interfaces are selected on IP, and the change was applied from Update. - [Should I block whole continents with GeoIP?](https://pfblockerng.com/faq/#geoip-continents): Usually not. pfSense already blocks unsolicited inbound traffic on WAN, so GeoIP there only helps with open ports. Prefer permitting selected countries, and protect open WAN ports and outbound LAN traffic. - [Can I create my own pfB_ alias?](https://pfblockerng.com/faq/#pfb-alias): No. The pfB_ prefix is reserved, and pfBlockerNG deletes any pfB_ alias it does not manage. Give your alias another name; it can still reference pfB_* aliases as members. - [How do I fix a false positive?](https://pfblockerng.com/faq/#false-positive): It depends on what blocked it. Find the event in Reports: an IP block needs an IP exception (suppress the address or smallest CIDR), a DNSBL block needs a DNSBL whitelist entry. One does not unblock the other. Reload, verify, and report a bad entry to the feed maintainer. - [What happens when a feed download fails?](https://pfblockerng.com/faq/#feed-download-fails): pfBlockerNG reloads the previously downloaded list, keeping your last known good policy. A download-failure threshold on General limits repeated attempts. Check Logs before replacing the source. - [Should I enable every feed?](https://pfblockerng.com/faq/#every-feed): No. Feeds are used at your own risk and the Feeds page warns not to enable them all at once. Start from the wizard defaults and add groups one at a time. - [Where do I get help?](https://pfblockerng.com/faq/#get-help): Ask usage questions on r/pfBlockerNG, report defects as GitHub issues, or use the Netgate forum. Include pfSense version, package version and channel, the component and redacted log lines. - [How can I support the project?](https://pfblockerng.com/faq/#support-project): Star it on GitHub, join on Patreon, help others in the forum, send feedback or patches. Custom, site-specific features are also possible: contact@pfblockerng.com. ## Project - [Source code on GitHub](https://github.com/pfBlockerNG/pfBlockerNG): issues, pull requests and releases - [Package repository](https://pkg.pfblockerng.com/): install commands per channel (Stable, Testing, Edge, Nightly) - [r/pfBlockerNG](https://www.reddit.com/r/pfBlockerNG/): community questions and answers - [Website updates feed](https://pfblockerng.com/updates.xml): new pages, guides and features (RSS 2.0) - [Combined feed](https://pfblockerng.com/feed.xml): website updates, releases and r/pfBlockerNG posts (RSS 2.0)