UniFi Controller - Revision history

Zcrayfish: This article has got to go.

2024-01-13T09:25:51Z

This article has got to go.

← Older revision		Revision as of 09:25, 13 January 2024
Line 1:		Line 1:
	{{TOC right}}		{{TOC right}}

			{{Delete\|Due to the warning below ⬇️, the unavailability of the image file for the controller (link below has been dead for ages), and Alpine Linux 3.9 being support level "none", there's no reason to keep this article any longer.}}

	{{Warning\|The Ubiquiti Unifi controller Linux self-contained Java image relies on MongoDB, and MongoDB has been removed from Alpine Linux after version 3.9 due to SPL license changes, so this guide doesn't work.}}		{{Warning\|The Ubiquiti Unifi controller Linux self-contained Java image relies on MongoDB, and MongoDB has been removed from Alpine Linux after version 3.9 due to SPL license changes, so this guide doesn't work.}}

Zcrayfish: URL cleanup

2023-07-26T13:15:38Z

URL cleanup

← Older revision		Revision as of 13:15, 26 July 2023
Line 5:		Line 5:
	== Introduction ==		== Introduction ==

	This guide explains how to install the generic Unix UniFi Controller, as available from [~~http~~://www.ui.com/ Ubiquiti Networks]. At the time of writing this, a native Alpine Linux package is not available.		This guide explains how to install the generic Unix UniFi Controller, as available from [https://www.ui.com/ Ubiquiti Networks]. At the time of writing this, a native Alpine Linux package is not available.

	Furthermore, this guide uses the incredibly reliable and efficient [~~http~~://www.skarnet.org/software/s6/ s6] supervision suite to start and control the UniFi Controller.		Furthermore, this guide uses the incredibly reliable and efficient [https://www.skarnet.org/software/s6/ s6] supervision suite to start and control the UniFi Controller.

	A summarized schematic of what will be installed on the filesystem.		A summarized schematic of what will be installed on the filesystem.
Line 63:		Line 63:
	== s6 ==		== s6 ==

	Install [~~http~~://www.skarnet.org/software/s6/ s6]		Install [https://www.skarnet.org/software/s6/ s6]

	<code>apk add s6</code> which is a service supervision suite, for reliably and efficiently starting, stopping and keeping services running.		<code>apk add s6</code> which is a service supervision suite, for reliably and efficiently starting, stopping and keeping services running.
Line 90:		Line 90:
	Download the generic unix archive of the <code>VERSION</code> you wish to install.		Download the generic unix archive of the <code>VERSION</code> you wish to install.

	<code>wget ~~http~~://www.ubnt.com/downloads/unifi/VERSION/UniFi.unix.zip</code>		<code>wget https://www.ubnt.com/downloads/unifi/VERSION/UniFi.unix.zip</code>{{dead_link}}

	Unpack the archive.		Unpack the archive.

Bbbhltz: Used warning template

2023-07-04T17:48:35Z

Used warning template

← Older revision		Revision as of 17:48, 4 July 2023
Line 1:		Line 1:
	{{TOC right}}		{{TOC right}}

	= '~~''''Notice''''' =~~		{{Warning\|The Ubiquiti Unifi controller Linux self-contained Java image relies on MongoDB, and MongoDB has been removed from Alpine Linux after version 3.9 due to SPL license changes, so this guide doesn't work.}}

	The Ubiquiti Unifi controller linux self-contained java image relies on MongoDB, and MongoDB has been removed from alpine linux packages after version 3.9 due to SPL license changes, so this guide doesn't work.		== Introduction ==

	= Introduction =

	This guide explains how to install the generic Unix UniFi Controller, as available from [http://www.ui.com/ Ubiquiti Networks]. At the time of writing this, a native Alpine Linux package is not available.		This guide explains how to install the generic Unix UniFi Controller, as available from [http://www.ui.com/ Ubiquiti Networks]. At the time of writing this, a native Alpine Linux package is not available.

Psykose: remove terrible workaround info

2023-07-04T14:35:22Z

remove terrible workaround info

← Older revision		Revision as of 14:35, 4 July 2023
Line 3:		Line 3:
	= '''''Notice''''' =		= '''''Notice''''' =

	The Ubiquiti Unifi controller linux self-contained java image relies on MongoDB, and MongoDB has been removed from alpine linux packages after version 3.9 due to SPL license changes~~. MongoDB can technically be installed by adding Alpine Linux 3.9 repositories and installing mongodb and yaml-cpp=0.6.2-r2~~, ~~however~~ this ~~solution requires pinning yaml-cpp to version 0.6.2, which is likely to cause issues with any other packages relying on yaml parsing using yaml-cpp~~.		The Ubiquiti Unifi controller linux self-contained java image relies on MongoDB, and MongoDB has been removed from alpine linux packages after version 3.9 due to SPL license changes, so this guide doesn't work.

	= Introduction =		= Introduction =

Jdusablon: Add warning about the effective deprecation of MongoDB on Alpine Linux >v.3.9

2023-07-04T06:41:58Z

Add warning about the effective deprecation of MongoDB on Alpine Linux >v.3.9

← Older revision		Revision as of 06:41, 4 July 2023
Line 1:		Line 1:
	{{TOC right}}		{{TOC right}}

			= '''''Notice''''' =

			The Ubiquiti Unifi controller linux self-contained java image relies on MongoDB, and MongoDB has been removed from alpine linux packages after version 3.9 due to SPL license changes. MongoDB can technically be installed by adding Alpine Linux 3.9 repositories and installing mongodb and yaml-cpp=0.6.2-r2, however this solution requires pinning yaml-cpp to version 0.6.2, which is likely to cause issues with any other packages relying on yaml parsing using yaml-cpp.

	= Introduction =		= Introduction =

GrumpyMeow: Wrong path probably due to copy/paste

2022-10-01T12:46:58Z

Wrong path probably due to copy/paste

← Older revision		Revision as of 12:46, 1 October 2022
Line 174:		Line 174:
	Ensure that the log/run script is executable:		Ensure that the log/run script is executable:

	<code>chmod 755 /etc/unifi/run</code>		<code>chmod 755 /etc/unifi/log/run</code>

	== Create log User and Directory ==		== Create log User and Directory ==

Zcrayfish: /* Introduction */ Fixed a URL with excessive redirects. Fixed company name. Minor fixes to grammar and spelling. Used path template.

2021-12-20T19:25:54Z

Introduction: Fixed a URL with excessive redirects. Fixed company name. Minor fixes to grammar and spelling. Used path template.

← Older revision		Revision as of 19:25, 20 December 2021
Line 3:		Line 3:
	= Introduction =		= Introduction =

	This guide explains how to install the generic Unix UniFi Controller, as available from [http://www.~~ubnt~~.com/ ~~Ubiquity~~ Networks]. At the time of writing this, a native Alpine Linux package is not available.		This guide explains how to install the generic Unix UniFi Controller, as available from [http://www.ui.com/ Ubiquiti Networks]. At the time of writing this, a native Alpine Linux package is not available.

	Furthermore, this guide uses the incredibly reliable and efficient [http://www.skarnet.org/software/s6/ s6] supervision suite to start and control the UniFi Controller.		Furthermore, this guide uses the incredibly reliable and efficient [http://www.skarnet.org/software/s6/ s6] supervision suite to start and control the UniFi Controller.

	A ~~summarised~~ schematic of what will be installed on the filesystem.		A summarized schematic of what will be installed on the filesystem.

	The choice of ~~<code>~~/srv~~</code>~~ for the UniFi Controller's root directory is based on the fact that it contains both run-time and configuration data, so installing to ~~<code>~~/usr/local~~</code>~~, ~~<code>~~/opt~~</code>~~ or ~~<code>~~/home~~</code>~~ didn't seem ~~apt~~. Feel free to adjust the steps below, replacing ~~<code>~~/srv/unifi~~</code>~~ with wherever you would prefer to install the UniFi Controller software.		The choice of {{path\|/srv}} for the UniFi Controller's root directory is based on the fact that it contains both run-time and configuration data, so installing to {{path\|/usr/local}}, {{path\|/opt}} or {{path\|/home}} didn't seem appropriate. Feel free to adjust the steps below, replacing {{path\|/srv/unifi}} with wherever you would prefer to install the UniFi Controller software.

	<pre>		<pre>

Zcrayfish: Removed a hyperlink to a hypothetical URL.

2021-12-20T19:23:11Z

Removed a hyperlink to a hypothetical URL.

← Older revision		Revision as of 19:23, 20 December 2021
Line 43:		Line 43:
	Edit <code>/etc/apk/repositories</code> and uncomment the appropriate community repository for your Alpine version:		Edit <code>/etc/apk/repositories</code> and uncomment the appropriate community repository for your Alpine version:

	<code>http://host.name/alpine_version/community</code>		<code><nowiki>http://host.name/alpine_version/community</nowiki></code>

	Update the package cache.		Update the package cache.

Bendoin: /* OpenJDK 8 JRE */

2021-03-27T13:04:46Z

OpenJDK 8 JRE

← Older revision		Revision as of 13:04, 27 March 2021
Line 41:		Line 41:
	Install <code>openjdk8-jre</code> from the community repository.		Install <code>openjdk8-jre</code> from the community repository.

	Edit <code>/etc/apk/~~respositories~~</code> and uncomment the appropriate community repository for your Alpine version:		Edit <code>/etc/apk/repositories</code> and uncomment the appropriate community repository for your Alpine version:

	<code>http://host.name/alpine_version/community</code>		<code>http://host.name/alpine_version/community</code>

Crusa: missing option for adduser command

2020-11-01T16:22:16Z

missing option for adduser command

← Older revision		Revision as of 16:22, 1 November 2020
Line 180:		Line 180:
	Create the <code>log</code> user and group.		Create the <code>log</code> user and group.

	<code>adduser -D -H /var/log log</code>		<code>adduser -D -H -h /var/log log</code>

	Create the <code>/var/log/unifi</code> directory		Create the <code>/var/log/unifi</code> directory