Manifest files for CasaOS Apps
Go to file
Giuseppe Galilei ba4ae76a55
Unifi network application (#374)
Closes #371 

As said in issue #371, casaos currently offers unifi-controller, which
is being deprecated starting January 1st.
Linuxserver has replaced it with unifi-network-application. However
deployment is a bit more complicated.
You can read more
[here](https://docs.linuxserver.io/images/docker-unifi-network-application/).

I wrote a compose file that deploys both unifi-network-application and
mongodb.

For mongoDB the chosen version is 3.6 and I believe it should not be
changed, because:
- it is officially supported by unifi-network-application
- it is the latest mongodb version supported by ARMv8A devices (aka
Raspberry Pis), newer versions require ARMv8.2

For unifi-network-application I tested the latest version (as of today
8.0.24) and it seems to work well, however I'm asking for more testing
and opinions, reason why in the compose I left the "latest" tag.

The compose also creates a bridge network, needed for hostname
resolution between the two services, needed at least until [this
issue](https://github.com/IceWhaleTech/CasaOS/issues/1348) is resolved.

The only caveats, from a user perspective, are described in the app
"tips", I paste them here:

To properly initialize the database, before installing, create a file
named `init-mongo.js` in the `/DATA/AppData` folder, with
        the following content:
        ```
db.getSiblingDB("unifi-db").createUser({user: "unifi", pwd: "pass",
roles: [{role: "dbOwner", db: "unifi-db"}]});
db.getSiblingDB("unifi-db_stat").createUser({user: "unifi", pwd: "pass",
roles: [{role: "dbOwner", db: "unifi-db_stat"}]});
        ```
This file is used only upon the first container start, to perform
initial configuration.
If you want, you can change the password `pass` modifying this file and
then the container's environment variables.

Because the network application runs inside Docker by default it uses an
IP address not accessible by other devices.
So, for it to adopt other devices, it is required to use port `8080` and
change the inform IP address. To do so, go in settings
and search for the `Inform Host` option, there select override and set
the address to that of the host.
Often, it is also needed to ssh into the devices you want to adopt and
manually set the inform IP address, the command
needed for doing so is `set-inform http://HOST-ADDRESS:8080/inform`.

For more
[information](https://docs.linuxserver.io/images/docker-unifi-network-application/)

I'm currently using an almost identical compose, deployed through
portainer on a Raspberry Pi 3 not using CasaOS, and it is working
flawlessly. (be careful on low memory devices because this application
can use about 500MB of memory)
I tested this PR on an x86 device and I can confirm deployment is
succesful and the network-application launches and configures correctly.
However I didn't test the adoption of unifi devices and everyday usage.
I believe there should be no issue, but any other test is warmly
welcomed.
Other useful info:
https://github.com/GiuseppeGalilei/Ubiquiti-Tips-and-Tricks/blob/main/Unifi%20network%20application%20-%20CasaOS/instructions.md

Happy holidays!

---------

Co-authored-by: Tiger Wang <tigerwang@outlook.com>
2024-01-26 17:54:26 +08:00
.github fix: fix lose push appstore (#405) 2024-01-26 15:49:08 +08:00
Apps Unifi network application (#374) 2024-01-26 17:54:26 +08:00
build/scripts/setup/script.d add release workflow (#21) 2023-03-01 16:11:12 -05:00
help Update action.sh 2022-01-12 11:35:21 +08:00
psd-source add contribution guidelines for icon, thumbnail and screenshots (#163) 2023-05-25 16:38:19 -04:00
.gitignore Add Tautulli app (#12) 2023-02-28 14:50:03 +08:00
CODE_OF_CONDUCT.md create CODE_OF_CONDUCT.md 2023-05-18 12:36:47 -04:00
CONTRIBUTING.md update CONTRIBUTING.md (#320) 2023-11-03 11:31:20 +08:00
LICENSE create LICENSE 2023-05-18 12:37:56 -04:00
README.md update README.md (#317) 2023-11-03 11:20:29 +08:00
category-list.json fix corrupted `category-list.json` (#200) 2023-07-04 18:43:40 -04:00
featured-apps.json Create featured-apps.json 2021-12-30 11:18:22 +08:00
recommend-list.json add recommend-list.json (#20) 2023-03-01 10:36:45 -05:00

README.md

CasaOS AppStore

GitHub issues by-label GitHub contributors

CasaOS AppStore needs your help to grow:

  • See CONTRIBUTING.md for how to contribute CasaOS Apps in Docker Compose format.

    IMPORTANT: Your PR must be well tested on your own CasaOS first. This is the mandatory first step for your submission.

  • Check help wanted for which issues you can help with.

Thank you!