mudhorn/docker-unifi-network-application
1
0
Fork 0
mirror of https://github.com/linuxserver/docker-unifi-network-application.git synced 2024-11-09 23:24:08 -08:00
Code Issues Actions 2 Packages Projects Releases Wiki Activity

Tweak readme wording to try and help users with first time setup

Browse source
This commit is contained in:
TheSpad 2023-09-25 16:32:16 +01:00
parent b814b00dd1
commit f2e9fb1a12
No known key found for this signature in database
GPG key ID: 08F06191F4587860
2 changed files with 24 additions and 10 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

17
README.md
View file

@ -59,9 +59,9 @@ The architectures supported by this image are:
## Application Setup
### This container requires an external mongodb database instance.
After setup, the web UI is available at https://ip:8443. The application can be configured, or a backup restored, using the first run wizard.
The web UI is at https://ip:8443, setup with the first run wizard.
**This container requires an external mongodb database instance.**
### Setting Up Your External Database
@ -78,14 +78,21 @@ db.getSiblingDB("MONGO_DBNAME_stat").createUser({user: "MONGO_USER", pwd: "MONGO
Being sure to replace the placeholders with the same values you supplied to the Unifi container, and mount it into your *mongodb* container.
For example:
```yaml
volumes:
- ./init-mongo.js:/docker-entrypoint-initdb.d/init-mongo.js:ro
unifi-db:
image: docker.io/mongo:<version tag>
container_name: unifi-db
volumes:
- /path/to/data:/data/db
- /path/to/init-mongo.js:/docker-entrypoint-initdb.d/init-mongo.js:ro
restart: unless-stopped
```
*Note that the init script method will only work on first run. If you start the mongodb container without an init script it will generate test data automatically and you will have to manually create your databases, or restart with a clean `/data/db` volume and an init script mounted.*
*If you are using the init script method do not also set `MONGO_INITDB_ROOT_USERNAME` or `MONGO_INITDB_ROOT_PASSWORD` values as they will cause conflicts.*
*If you are using the init script method do not also set `MONGO_INITDB_ROOT_USERNAME`, `MONGO_INITDB_ROOT_PASSWORD`, or any other "INITDB" values as they will cause conflicts.*
You can also run the commands directly against the database using either `mongo` (< 6.0) or `mongosh` (>= 6.0).

17
readme-vars.yml
View file

@ -53,9 +53,9 @@ opt_param_ports:
# application setup block
app_setup_block_enabled: true
app_setup_block: |
### This container requires an external mongodb database instance.
After setup, the web UI is available at https://ip:8443. The application can be configured, or a backup restored, using the first run wizard.
The web UI is at https://ip:8443, setup with the first run wizard.
**This container requires an external mongodb database instance.**
### Setting Up Your External Database
@ -72,14 +72,21 @@ app_setup_block: |
Being sure to replace the placeholders with the same values you supplied to the Unifi container, and mount it into your *mongodb* container.
For example:
```yaml
volumes:
- ./init-mongo.js:/docker-entrypoint-initdb.d/init-mongo.js:ro
unifi-db:
image: docker.io/mongo:<version tag>
container_name: unifi-db
volumes:
- /path/to/data:/data/db
- /path/to/init-mongo.js:/docker-entrypoint-initdb.d/init-mongo.js:ro
restart: unless-stopped
```
*Note that the init script method will only work on first run. If you start the mongodb container without an init script it will generate test data automatically and you will have to manually create your databases, or restart with a clean `/data/db` volume and an init script mounted.*
*If you are using the init script method do not also set `MONGO_INITDB_ROOT_USERNAME` or `MONGO_INITDB_ROOT_PASSWORD` values as they will cause conflicts.*
*If you are using the init script method do not also set `MONGO_INITDB_ROOT_USERNAME`, `MONGO_INITDB_ROOT_PASSWORD`, or any other "INITDB" values as they will cause conflicts.*
You can also run the commands directly against the database using either `mongo` (< 6.0) or `mongosh` (>= 6.0).