docker-compose-unifi-network-application

Table of Contents

• Quick reference
• Why?
• Requirements
• Quick Start
• Step by step
  • Create a new project directory
  • Create the .env file
  • Download Docker Compose Configuration File
  • Launch Docker Containers
  • Open Web App
• Remove/Uninstall

---

Quick reference

• pjortiz/docker-unifi-mongo
• linuxserver/unifi-network-application Official Image
• Mongo Official Image

---

Why?

This compose file aims to make the deployment as painless and easy as possable while still attempting to support all the Mongo versions¹.

---

Requirements

• A system with Docker and Docker Compose installed and working.
• A basic understanding on how to deploy docker-compose.yml files.

---

Quick Start

Copy the below command into any CLI. ²

Make sure to change MONGO_PASS and set MONGO_VERSION as needed.

printf "MONGO_VERSION=6.0.15\nMONGO_PASS=changeme" > .env && curl -Lf -o docker-compose.yml https://raw.githubusercontent.com/pjortiz/docker-compose-unifi-network-application/main/docker-compose.yml && docker compose -p unifi-network-application --env-file .env up --detach

Note: this docker-compose.yml uses Mongo version 6.0.15 by default, so specifying MONGO_VERSION above with the same is technically redundant.

Clean up left over files if needed with below command.

rm -f .env docker-compose.yml

---

Step by step

Create a new project directory

Create a new project directory and name it unifi-network-application. Here you will place the .env and docker-compose.yml files as detailed in the next steps.

Create the .env file

Download the .env.template file and rename it to .env or create an empty file.

Add/Change the following:

MONGO_VERSION=6.0.15    # Optional, if not provided uses default
MONGO_PASS=changeme     # Required

Change the MONGO_PASS to what every you want. And set the MONGO_VERSION to meet your needs or leave default.

Download Docker Compose Configuration File

Either download through your browser or using the command below:

curl -Lf -o docker-compose.yml https://raw.githubusercontent.com/pjortiz/docker-compose-unifi-network-application/main/docker-compose.yml

Launch Docker Containers

Open a CLI and make sure your working directory is in the same and the .env and docker-compose.yml, then run the this command:

docker compose -p unifi-network-application --env-file .env up --detach

Open Web App

Open your web browser and navigate to https://localhost:8443 or the IP/Domain of your host system.

---

Remove/Uninstall

To remove run the following command:

docker compose -p unifi-network-application rm --stop

Add option --volumes after rm to remove volumes as well.

Footnotes

1. I have not verified that all version are working for myself. But version 5 and 6 seem to be working during my testing. ↩

2. For the printf , curl and rm commands, Windows users may need to have GitBash installed or similar that provide these CLI commands. ↩