MyFavMirrors/moonfire-nvr
1
0
Fork 0
mirror of https://github.com/scottlamb/moonfire-nvr.git synced 2024-12-26 15:15:56 -05:00
Code Issues Packages Projects Releases Wiki Activity

install instructions updates

Browse Source 
Fixes #204

* The docker container won't start if a bind refers to a path that
  doesn't exist yet, so move the /etc/moonfire-nvr.json creation up
* Remove redundant command in the dedicated hard drive setup, and
  improve its clarity
This commit is contained in:
Scott Lamb 2022-03-11 15:02:29 -08:00
parent 78cdd82f36
commit 0a9ec04a4e
1 changed files with 29 additions and 34 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

63
guide/install.md
View File

@ -50,15 +50,35 @@ and managing a long-lived Docker container for its web interface.
As you set up this script, adjust the `tz` variable as appropriate for your As you set up this script, adjust the `tz` variable as appropriate for your
time zone. time zone.
Use your favorite editor to create `/usr/local/bin/nvr`, starting from the Use your favorite editor to create `/etc/moonfire-nvr.json` and
configuration below: `/usr/local/bin/nvr`, starting from the configurations below:
```console ```console
$ sudo nano /etc/moonfire-nvr.json
(see below for contents)
$ sudo nano /usr/local/bin/nvr $ sudo nano /usr/local/bin/nvr
(see below for contents) (see below for contents)
$ sudo chmod a+rx /usr/local/bin/nvr $ sudo chmod a+rx /usr/local/bin/nvr
``` ```
`/etc/moonfire-nvr.json`:
```json
{
"binds": [
{
"ipv4": "0.0.0.0:8080",
"allowUnauthenticatedPermissions": {
"viewVideo": true
}
},
{
"unix": "/var/lib/moonfire-nvr/sock",
"ownUidIsPrivileged": true
}
]
}
```
`/usr/local/bin/nvr`: `/usr/local/bin/nvr`:
```bash ```bash
#!/bin/bash -e #!/bin/bash -e
@ -150,8 +170,11 @@ using UAS, as described there. UAS has been linked to filesystem corruption.
Set up the mount point and sample file directory: Set up the mount point and sample file directory:
```console ```console
$ sudo vim /etc/fstab $ sudo blkid
$ sudo mkdir /media/nvr (note the UUID of your new device)
$ sudo nano /etc/fstab
(see below for line to add)
$ sudo mkdir -p /media/nvr
$ sudo mount /media/nvr $ sudo mount /media/nvr
$ sudo install -d -o moonfire-nvr -g moonfire-nvr -m 700 /media/nvr/sample $ sudo install -d -o moonfire-nvr -g moonfire-nvr -m 700 /media/nvr/sample
``` ```
@ -162,23 +185,14 @@ In `/etc/fstab`, add a line similar to this:
UUID=23d550bc-0e38-4825-acac-1cac8a7e091f /media/nvr ext4 nofail,noatime,lazytime,data=writeback,journal_async_commit 0 2 UUID=23d550bc-0e38-4825-acac-1cac8a7e091f /media/nvr ext4 nofail,noatime,lazytime,data=writeback,journal_async_commit 0 2
``` ```
You can look up the correct uuid for your disk via `blkid`.
If you use the `nofail` attribute in `/etc/fstab` as described above, your If you use the `nofail` attribute in `/etc/fstab` as described above, your
system will boot successfully even when the hard drive is unavailable (such as system will boot successfully even when the hard drive is unavailable (such as
when your external USB storage is unmounted). This can be helpful when when your external USB storage is unmounted). This can be helpful when
recovering from problems. recovering from problems.
Create the sample directory.
```console
$ sudo mkdir /media/nvr/sample
$ sudo chown -R moonfire-nvr:moonfire-nvr /media/nvr
```
Add a new `--mount` line to your Docker wrapper script `/usr/local/bin/nvr` Add a new `--mount` line to your Docker wrapper script `/usr/local/bin/nvr`
to expose this new volume to the Docker container, right where a comment to expose the new sample directory `/media/nvr/sample` to the Docker container,
mentions "Additional mount lines". right where a comment mentions "Additional mount lines".
### Completing configuration through the UI ### Completing configuration through the UI
@ -258,25 +272,6 @@ In the user interface,
### Starting it up ### Starting it up
You'll need to create the runtime configuration file, `/etc/moonfire-nvr.json`:
```json
{
"binds": [
{
"ipv4": "0.0.0.0:8080",
"allowUnauthenticatedPermissions": {
"viewVideo": true
}
},
{
"unix": "/var/lib/moonfire-nvr/sock",
"ownUidIsPrivileged": true
}
]
}
```
With this config, Moonfire NVR's web interface is **insecure**: it doesn't use With this config, Moonfire NVR's web interface is **insecure**: it doesn't use
`https` and doesn't require you to authenticate to it. You might be comfortable `https` and doesn't require you to authenticate to it. You might be comfortable
starting it in this configuration to try it out, particularly if the machine starting it in this configuration to try it out, particularly if the machine