https://github.com/ryansch/docker-unifi-rpi

Unifi Controller for Raspberry Pi 3+ and x86
https://github.com/ryansch/docker-unifi-rpi

docker raspberry-pi unifi unifi-controller

Last synced: 4 days ago
JSON representation

Unifi Controller for Raspberry Pi 3+ and x86

• Host: GitHub
• URL: https://github.com/ryansch/docker-unifi-rpi
• Owner: ryansch
• Created: 2016-04-28T21:59:38.000Z (over 8 years ago)
• Default Branch: main
• Last Pushed: 2024-09-01T13:22:33.000Z (4 months ago)
• Last Synced: 2024-12-22T20:05:48.594Z (11 days ago)
• Topics: docker, raspberry-pi, unifi, unifi-controller
• Language: Shell
• Homepage: https://hub.docker.com/r/ryansch/unifi-rpi/
• Size: 559 KB
• Stars: 350
• Watchers: 27
• Forks: 41
• Open Issues: 11
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Overview

Docker images for running Ubiquiti's [UniFi Controller software](https://www.ubnt.com/download/unifi/).

# Supported tags and respective `Dockerfile` directory links

- [`8.2.93`, `8.2` (v8.2.93/8.2)](https://github.com/ryansch/docker-unifi-rpi/tree/v8.2.93/8.2)

- [`8.3.32`, `8.3` (v8.3.32/8.3)](https://github.com/ryansch/docker-unifi-rpi/tree/v8.3.32/8.3)

- [`8.4.59`, `8.4`, `8`, `latest` (v8.4.59/8.4)](https://github.com/ryansch/docker-unifi-rpi/tree/v8.4.59/8.4)

## Versions

⚠️  This project is transitioning to MongoDB 4.4. Direct upgrades are not possible! ⚠️

I've added a check in the entrypoint that will prevent the Network Application (controller) from starting if

the database files are from an older mongo and need to be upgraded. This will allow you to rollback to the container version you were using without issue. You can then schedule the upgrade when it's convenient.

Upgrade instructions are here: 

Ubiquiti releases 'unstable', 'testing', and 'stable candidate' versions as part of its beta group release structure.  These releases are included here.  Only stable releases are tagged with their general version (ex: `5.6` for the `5.6.30` stable release) or with `latest`.

## Supported Architectures

| Architecture | Available | Tag |

| :----: | :----: | ---- |

| amd64 | ✅ | \-amd64 |

| arm64v8 | ✅ | \-arm64v8 |

| arm32v7 | ❌ | |

Note: arm32v7 is no longer supported due to a lack of upstream support for mongodb <= 3.6 for arm32/armhf

# Configuration

As of 7.5.x, this container image supports unifi's standard configuration utilities.

You can supply a system.properties file at `/var/lib/unifi/system.properies` (in the container) or set any of the following environment variables:

| Environment Variable | Description | Default |

| --- | --- | --- |

| JVM_INIT_HEAP_SIZE | Initial Java heap size in MiB | None |

| JVM_MAX_HEAP_SIZE | Maximum Java heap size in MiB | 1024 |

| JAVA_ENTROPY_GATHER_DEVICE | Path to entropy gathering device | None |

| UNIFI_JVM_EXTRA_OPTS | Additional JVM options | $JAVA_OPTS |

Additionally, `-XX:+UseParallelGC` is used by default but can be changed with the unifi property `unifi.G1GC.enabled`.

# Usage

Documentation is in the [wiki](https://github.com/ryansch/docker-unifi-rpi/wiki).

# Building

- `./build.sh -v  -u  [-t  ...]`

Example: `./build.sh -v 5.9.29 -u 5.9.29-04b5d20997 -t 5.9 -t 5 -t latest`

# Publishing

- `./publish.sh -v  -u `

Example: `./publish.sh -v 5.9.29 -u 5.9.29-04b5d20997`

# Tagging a stable release

- `./tag.sh -v  -u  [-t  ...]`

Example: `./tag.sh -v 5.9.29 -u 5.9.29-04b5d20997 -t 5.9 -t 5 -t latest`