Skip to content
This repository has been archived by the owner on Aug 24, 2021. It is now read-only.

Commit

Permalink
Docs
Browse files Browse the repository at this point in the history
  • Loading branch information
marcoraddatz committed May 4, 2017
1 parent 43bf57d commit f5cd1e0
Show file tree
Hide file tree
Showing 2 changed files with 19 additions and 13 deletions.
28 changes: 15 additions & 13 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,9 +16,9 @@ Create a folder via DSM File Station at `/volume1/docker/homebridge` and put you

![File Station.](https://raw.githubusercontent.com/marcoraddatz/homebridge-docker/master/doc/file-station-1.png)

Here are two examples of how your setup files can look like:
Here are two examples of how your setup files may look like:

#### package.json
#### [package.json](samples/package.json)

```json
{
Expand All @@ -35,7 +35,7 @@ Here are two examples of how your setup files can look like:
}
```

#### install.sh
#### [install.sh](samples/install.sh)

*Note that you can also use this file to install server dependencies!*

Expand All @@ -52,23 +52,21 @@ Since version 2.1 all commands get executed as root.

### 3. Start Container

After your plugins have been configured, you can launch the Docker container.
Once the plugins have been set up, the Docker container is ready to launch.

![Launch container.](https://raw.githubusercontent.com/marcoraddatz/homebridge-docker/master/doc/docker-2.png)

![Click 'Advanced Settings'.](https://raw.githubusercontent.com/marcoraddatz/homebridge-docker/master/doc/docker-3.png)

![Link local configs.](https://raw.githubusercontent.com/marcoraddatz/homebridge-docker/master/doc/docker-4.png)

Link the `/volume1/docker/homebridge` to `/root/.homebridge`, otherwise, the configuration files won’t be loaded (within DSM the path is only shown as `/docker/homebridge`. Make sure you **don’t** click "read only".
Link the `/volume1/docker/homebridge` to `/root/.homebridge`, otherwise, the configuration files won’t be loaded (within DSM the path is only shown as `/docker/homebridge`.

![Allow container to work act as host.](https://raw.githubusercontent.com/marcoraddatz/homebridge-docker/master/doc/docker-5.png)
![Use the same network as Docker host.](https://raw.githubusercontent.com/marcoraddatz/homebridge-docker/master/doc/docker-5.png)

Don't forget to click the *Use the same network as Docker Host* checkbox!
![Apply settings.](https://raw.githubusercontent.com/marcoraddatz/homebridge-docker/master/doc/docker-6.png)

![That's it!](https://raw.githubusercontent.com/marcoraddatz/homebridge-docker/master/doc/docker-6.png)

Once you launch (or restart) the container, Homebridge and all its dependencies will be installed. To verify that Homebridge is running or if an error occurs, you can use the container's log (Container → Details → Log) to find out the reason why.
Once you launch (or restart) the container, Homebridge and all its dependencies will get installed. To verify that Homebridge is running or if an error occurs, you can use the container's log (Container → Details → Log) to receive further information on the process.

## Command line

Expand All @@ -84,11 +82,11 @@ All `.env` variables are optional.

#### HOMEBRIDGE_ENV

- **production** _(default)_
- **production** _(default)_
Starts Homebridge without any options.
- **development**
- **development**
Starts Homebridge with plugin support.
- **debug**
- **debug**
Starts Homebridge with plugin support and maximum debugging info.

#### HOMEBRIDGE_VERSION
Expand All @@ -111,6 +109,10 @@ Most issues aren't related to this package, nor to Homebridge -- they are creat

Make sure that ports 5353 and 51826 (both TCP) aren't blocked by your firewall.

### 4. Adjust paths

If you're using a non-Synology device, you might need to adjust the paths to your config (`/volume1/docker/homebridge`).

## License

This project is licensed under Apache License V2 (see [LICENSE](LICENSE)).
Expand Down
4 changes: 4 additions & 0 deletions samples/install.sh
100644 → 100755
Original file line number Diff line number Diff line change
@@ -1,5 +1,9 @@
#!/bin/bash

# This file gets executed as root, so you can use it to
# install or update any plugin dependencies.
# See https://github.com/marcoraddatz/homebridge-docker#installsh

npm install -g homebridge-harmonyhub
npm install -g homebridge-netatmo
npm install -g homebridge-nukiio
Expand Down

0 comments on commit f5cd1e0

Please sign in to comment.