Skip to content

Commit

Permalink
Merge pull request #24 from versx/develop
Browse files Browse the repository at this point in the history
Release 1.5.4
  • Loading branch information
versx authored May 1, 2020
2 parents abb0e49 + a8a7308 commit 78fbe18
Show file tree
Hide file tree
Showing 31 changed files with 1,082 additions and 491 deletions.
19 changes: 9 additions & 10 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,18 +21,21 @@ You can also pre-create devices and assign configs yourself if needed.
2.) Install dependencies `npm install`
3.) Copy config `cp src/config.example.json src/config.json`
4.) Fill out config `vi src/config.json`
5.) Run `npm run start`
5.) Run `npm start`
6.) Access via http://machineip:port/ using username: `root` and password `pass123!`
7.) Change default password via the Settings page

## Updating
1.) `git pull`
2.) Run `npm install` in root folder
3.) Run `npm run start`
3.) Run `npm start`

## Notes
- If you use HAProxy, make sure to set `option forwardfor` in your haproxy.cfg if you are not passing the x-forward-for header so the correct IP addresses are saved.
- `Backend Url` and `Data Endpoints` do not need to have the `/raw` or `/controler` endpoints added to configs.
## FAQ
Q.) Why are devices showing my HAProxy IP address?
A.) You need to make sure to set `option forwardfor` in your haproxy.cfg file under defaults so the `x-forward-for` header is sent with the request and the real IP is used.

Q.) Why are devices not connecting to backend or sending data to data endpoints?
A.) Make sure to **not** include the `/raw` or `/controler` endpoints in the `Backend Url` and `Data Endpoints` config options. These are automatically appended to each URL address.

## PM2 (recommended)
Once everything is setup and running appropriately, you can add this to PM2 ecosystem.config.js file so it is automatically started:
Expand All @@ -51,8 +54,4 @@ module.exports = {
}
]
};
```

## TODO
- Support for other macless client provider configs with custom predefined configuration keys.
- Localization.
```
1 change: 1 addition & 0 deletions migrations/7.sql
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
ALTER TABLE `devices` ADD COLUMN `notes` VARCHAR(255) DEFAULT NULL;
Loading

0 comments on commit 78fbe18

Please sign in to comment.