selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

docker-unms logo

Self-host docker-unms

3.1.69

Docker image for self-hosted Ubiquiti UISP management

ReleaseOpen Source
Updated9 hours ago
LanguageDockerfile
Setup difficultyEasy
Stars
278
Ports
80 (HTTP web server), 443 (HTTPS and WSS web server), 2055 (Netflow (UDP))
Docker
nico640/docker-unms
Install with Docker

What is docker-unms?

docker-unms is a community-maintained Docker image that bundles the Ubiquiti Network Management System (UISP, formerly UNMS) into a single container. It includes all required components: the UISP application, nginx reverse proxy, NetFlow collector, CRM, SiriDB time-series database, PostgreSQL with TimescaleDB, and RabbitMQ message broker. The image uses s6-overlay for process management and supports both x86_64 and ARM (including Raspberry Pi) architectures. Users can deploy it via docker run or docker-compose with persistent configuration stored in a mounted volume. In-app upgrades are not supported; updates require pulling the latest image. The project is not affiliated with Ubiquiti Networks.

Should you self-host docker-unms?

docker-unms scores 45/100 on selfhost.directory (how scoring works) and ranks #24 of 34 in Network Management. It has 278 GitHub stars.

It shipped 5 stable releases in the past year. The latest, 3.1.69, came out on 22 October 2026. New versions land roughly every 2 months.

Setup is easy: most people get it running in one sitting. An official Docker image is available. It is written mostly in Dockerfile.

Its closest alternative on selfhost.directory is 3x-ui (84/100, 48 764 stars). It scores higher overall, so compare the two before you pick. See docker-unms vs 3x-ui side by side.

Features

  • All-in-one container
  • Configurable ports
  • Custom SSL Certificates
  • Demo Mode
  • Persistent configuration
  • User/group ID mapping

docker-unms README

How to install docker-unms

Install docker-unms with Docker

Docker
Environment variables
TZ, DEMO, PUBLIC_HTTPS_PORT, PUBLIC_WS_PORT, HTTPS_PORT, HTTP_PORT, SSL_CERT, SSL_CERT_KEY, PUID, PGID

docker run
-p 80:80
-p 443:443
-p 2055:2055/udp
-e TZ=
-v </path/to/config>:/config
nico640/docker-unms:latest

Basic docker run command with required ports and volume

How to configure docker-unms

  • DEMOfalseEnable UISP demo mode

    Enable UISP demo mode

    values: true|false

  • HTTP_PORT80HTTP port the container's webserver listens on

    HTTP port the container's webserver listens on

  • HTTPS_PORT443HTTPS port the container's webserver listens on

    HTTPS port the container's webserver listens on

  • PGID911Group ID of the container user

    Group ID of the container user

  • PUBLIC_HTTPS_PORT443HTTPS port exposed on the docker host

    HTTPS port exposed on the docker host

  • PUBLIC_WS_PORT443WebSocket port exposed on the docker host

    WebSocket port exposed on the docker host

  • PUID911User ID of the container user

    User ID of the container user

  • SSL_CERTFilename of custom SSL certificate in /config/usercert/

    Filename of custom SSL certificate in /config/usercert/

  • SSL_CERT_KEYFilename of custom SSL key in /config/usercert/

    Filename of custom SSL key in /config/usercert/

  • TZTimezone information (e.g. Europe/London)

    Timezone information (e.g. Europe/London)

    values: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones

docker-unms releases & version history

More in Docker

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…