GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Sign in
  • ActionsCI/CD and automation
  • CodespacesCloud development environments
  • All Features
  • Documentation
  • Training
  • Certifications
  • Build with Copilot
  • Customize Copilot
  • Integrations
  • Trending repos
  • GitHub Sponsors
  • Developer articles
  • Enterprises

This view

  • Original page
  • New address

GeezerVison is showing github.com — GitHub - daemonless/unifi: Ubiquiti UniFi Network Application for managing UniFi access points, switches, and gateways.

BranchesTags
Open more actions menu

Latest commit

 

History

109 Commits
109 Commits

Folders and files

NameName
Last commit message
Last commit date
.daemonless
.daemonless
 
 
.github/workflows
.github/workflows
 
 
root
root
 
 
.gitignore
.gitignore
 
 
Containerfile
Containerfile
 
 
Containerfile.j2
Containerfile.j2
 
 
Containerfile.pkg
Containerfile.pkg
 
 
Containerfile.pkg.j2
Containerfile.pkg.j2
 
 
LICENSE
LICENSE
 
 
README.md
README.md
 
 
compose.yaml
compose.yaml
 
 
sbom-aarch64.json
sbom-aarch64.json
 
 
sbom.json
sbom.json
 
 

Repository files navigation

UniFi Network

Build Status Last Commit OCI Pulls mlock Required

Ubiquiti UniFi Network Application for managing UniFi access points, switches, and gateways.

Port 8443
Registry ghcr.io/daemonless/unifi
Source https://ui.com/
Website https://ui.com/

Version Tags

Tag Description Best For
latest FreeBSD Latest. Rolling package updates. Staying current.
pkg / pkg-latest FreeBSD Latest. Rolling package updates. Staying current.

Prerequisites

Before deploying, ensure your host environment is ready. See the Quick Start Guide for host setup instructions.

Deployment

Podman Compose

services:
  unifi:
    image: "ghcr.io/daemonless/unifi:latest"
    container_name: unifi
    environment:
      - PUID=1000  # User ID for the application process
      - PGID=1000  # Group ID for the application process
      - TZ=UTC  # Timezone for the container
    volumes:
      - "/containers/unifi:/config"
    ports:
      - "8443:8443"
      - "8080:8080"
      - "8843:8843"
      - "8880:8880"
      - "6789:6789"
      - "3478:3478/udp"
      - "10001:10001/udp"
    annotations:
      org.freebsd.jail.allow.mlock: "true"
    # always (not unless-stopped) so FreeBSD's podman rc.d auto-starts it at boot
    restart: always

Save as compose.yaml, then run podman-compose up -d.

AppJail Director

.env:

# .env

DIRECTOR_PROJECT=unifi
PUID=1000
PGID=1000
TZ=UTC

appjail-director.yml:

# appjail-director.yml

options:
  - virtualnet: ':<random> default'
  - nat:
services:
  unifi:
    name: unifi
    options:
      - container: 'args:--pull'
      - expose: '8443:8443 proto:tcp'
      - expose: '8080:8080 proto:tcp'
      - expose: '8843:8843 proto:tcp'
      - expose: '8880:8880 proto:tcp'
      - expose: '6789:6789 proto:tcp'
      - expose: '3478:3478 proto:udp'
      - expose: '10001:10001 proto:udp'
      - template: !ENV '${PWD}/template.conf'
    oci:
      user: root
      environment:
        - PUID: !ENV '${PUID}'
        - PGID: !ENV '${PGID}'
        - TZ: !ENV '${TZ}'
    volumes:
      - unifi: /config
volumes:
  unifi:
    device: '/containers/unifi'

Makejail:

# Makejail

ARG tag=latest

OPTION container=boot
OPTION overwrite=force
OPTION from=ghcr.io/daemonless/unifi:${tag}

template.conf:

# template.conf

exec.start: "/bin/sh /etc/rc"
exec.stop: "/bin/sh /etc/rc.shutdown jail"
mount.devfs
persist
allow.mlock

Save the files above, then run appjail-director up.

Warning

Exposing ports in AppJail means that your service can be reached from remote hosts. If that is not your intention, do not expose the ports and communicate with the service using the jail's IPv4 address or hostname assigned by the virtual network.

To avoid exposing ports, just remove the expose option in your appjail-director.yml or from your command-line arguments.

Bastille

Warning

Bastille's OCI support is experimental. It requires buildah and shares the host network stack (inherit). Mount volumes with --volume HOST JAIL; without it, image-declared volumes are stored under ${bastille_volumesdir}/${jail}.

services:
  unifi:
    name: unifi
    image: "ghcr.io/daemonless/unifi:latest"
    network:
      - mode: host
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=UTC
    volumes:
      - "/containers/unifi:/config"

Save as bastille-compose.yml, then run bastille up.

Parameters

Environment Variables

Variable Default Description
PUID 1000 User ID for the application process
PGID 1000 Group ID for the application process
TZ UTC Timezone for the container

Volumes

Path Description
/config Configuration and database directory

Ports

Port Protocol Description
8443 TCP Web UI (HTTPS)
8080 TCP Device inform
8843 TCP Guest portal HTTPS
8880 TCP Guest portal HTTP
6789 TCP Mobile throughput test
3478 UDP STUN (UDP)
10001 UDP Device discovery (UDP)

Architectures: amd64, aarch64 User: bsd (UID/GID via PUID/PGID, defaults to 1000:1000) Base: FreeBSD 15.1


Need help? Join our Discord community.

About

Ubiquiti UniFi Network Application for managing UniFi access points, switches, and gateways.

daemonless.io/images/unifi/

Topics

containerdaemonlessfreebsdfreebsd-jailnetworkingocioci-imagepodmanself-hostedubiquitiunifiutilities

Resources

Readme
BSD-2-Clause license
Activity
Custom properties

Stars

3 stars

Watchers

1 watching

Forks

0 forks
Report repository

Releases

Packages

Contributors

Languages

You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.