Home / Blog /

My Straightforward Guide For Setting Up Poudriere On FreeBSD

  • 0
  • 2 mins

Poudriere is by far my favorite FreeBSD tool and one I use almost daily for stable, customized package management. Here's the step-by-step guide I made (for myself) to set it up.

People asked for this so I'm posting it (plus it's a great reference for me in case I forget!).

Let me know if I've missed anything.

The nginx part is optional but I'll leave that in here.

1. Install poudriere (obviously) and nginx (if you want to)

doas pkg install poudriere nginx

2. Edit config

doas vim /usr/local/etc/poudriere.conf


3. Create jail

doas poudriere jail -c -j freebsd_12-0x64 -v 12.0-RELEASEdoas poudriere jail -l

4. Retrieve ports

doas poudriere ports -c -p PORTSdoas poudriere ports -l

5. Create port-list

doas vim /usr/local/etc/poudriere.d/port-list

6. Build the ports

doas poudriere options -c -j freebsd_12-0x64 -p HEAD -f /usr/local/etc/poudriere.d/port-listdoas poudriere bulk -j freebsd_12-0x64 -p PORTS -f /usr/local/etc/poudriere.d/port-list

7. Nginx server block

doas vim /usr/local/etc/nginx/nginx.conf
    server {
        listen 8000;
        server_name localhost;
        root /usr/local/share/poudriere/html;

        location /data {
            alias /usr/local/poudriere/data/logs/bulk;
            autoindex on;

        location /packages {
            root /usr/local/poudriere/data;
            autoindex on;

8. Nginx log mime type

doas vim /usr/local/etc/nginx/mime.types
    text/plain                          txt log;

9. Restart nginx

doas service nginx restart

10. Configure repos

doas vim /usr/local/etc/pkg/repos/poudriere.conf
    poudriere: {
        url: "file:///usr/local/poudriere/data/packages/freebsd_11-2x64-PORTS",
        mirror_type: "srv",
        signature_type: NONE,
        enabled: yes,
        priority: 1
doas vim /usr/local/etc/pkg/repos/freebsd.conf
    FreeBSD: {
    	enabled: no
doas pkg update

11. Installing custom packages

doas pkg install -package-

If package is already installed, reinstall with:

doas pkg install -r poudriere -f -package-

12. Updating

doas poudriere jail -u -j freebsd_12-0x64doas poudriere ports -u -p PORTS

13. Upgrading packages

Basically rinse and repeat Steps 5 and 6.


Some of the steps will depend on your situation (e.g. FreeBSD version, packages, enabling/disabling FreeBSD repo, nginx). Customize accordingly.

Redpill your friends:
Donovan Nagel
Applied Linguistics graduate, translator and entrepreneur who uses FreeBSD and OpenBSD exclusively for work.
Subscribe to my YouTube channel.

Got something to share?

Comment Policy: This is a free-speech zone but cuntery isn't tolerated. Also no "Linux can do that" flame wars.
All comments are moderated before being published.