Skip to content
This repository was archived by the owner on Feb 21, 2022. It is now read-only.

Commit 3d877c1

Browse files
committed
Updating README.md
Added info.md and CONTRIBUTING.md
1 parent 2977545 commit 3d877c1

File tree

3 files changed

+99
-9
lines changed

3 files changed

+99
-9
lines changed

CONTRIBUTING.md

+46
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
# Contribution guidelines
2+
3+
Contributing to this project should be as easy and transparent as possible, whether it's:
4+
5+
- Reporting a bug
6+
- Discussing the current state of the code
7+
- Submitting a fix
8+
- Proposing new features
9+
10+
## Github is used for everything
11+
12+
Github is used to host code, to track issues and feature requests, as well as accept pull requests.
13+
14+
Pull requests are the best way to propose changes to the codebase.
15+
16+
1. Fork the repo and create your branch from `master`.
17+
2. If you've changed something, update the documentation.
18+
3. Make sure your code lints (using black).
19+
4. Issue that pull request!
20+
21+
## Any contributions you make will be under the Apache 2.0 Software License
22+
23+
In short, when you submit code changes, your submissions are understood to be under the same [Apache 2.0](https://choosealicense.com/licenses/apache-2.0/) that covers the project. Feel free to contact the maintainers if that's a concern.
24+
25+
## Report bugs using Github's [issues](https://github.com/jiminald/unraid/issues)
26+
27+
GitHub issues are used to track public bugs.
28+
Report a bug by [opening a new issue](https://github.com/jiminald/unraid/issues/new/choose); it's that easy!
29+
30+
## Write bug reports with detail, background, and sample code
31+
32+
**Great Bug Reports** tend to have:
33+
34+
- A quick summary and/or background
35+
- Steps to reproduce
36+
- Be specific!
37+
- Give sample code if you can.
38+
- What you expected would happen
39+
- What actually happens
40+
- Notes (possibly including why you think this might be happening, or stuff you tried that didn't work)
41+
42+
People *love* thorough bug reports. I'm not even kidding.
43+
44+
## License
45+
46+
By contributing, you agree that your contributions will be licensed under its Apache 2.0 License.

README.md

+19-9
Original file line numberDiff line numberDiff line change
@@ -1,24 +1,34 @@
11
# homeassistant-unraid
22

3-
![GitHub](https://img.shields.io/github/license/jiminald/homeassistant-unraid)
3+
![GitHub](https://img.shields.io/github/license/jiminald/unraid)
44
[![hacs_badge](https://img.shields.io/badge/HACS-Custom-orange.svg)](https://github.com/custom-components/hacs)
55

66
This is a custom component for [Home Assistant](http://home-assistant.io) that adds [UnRAID](http://unraid.net) data as a sensor to HA.
77

8-
Tested on Unraid 6.8-RC9
8+
This component uses a GraphQL API component for a under development module [unraid.net](https://github.com/limetech/Unraid.net)
9+
10+
Tested on Unraid 6.8
11+
12+
## Setup
13+
14+
First, you will need to install the unraid.net plugin onto your unraid instance [https://github.com/limetech/Unraid.net/blob/next/Unraid.net.plg](https://github.com/limetech/Unraid.net/blob/next/Unraid.net.plg)
15+
16+
This will add a new section to your Settings > Management Access titled unraid.net. Register your instance using your unraid.net forum account.
17+
18+
Now SSH into your unraid installation and run the following command
19+
`/etc/rc.d/rc.unraid-api start`
920

1021
## Config
1122

12-
In `/boot/config/plugins/dynamix/dynamix.cfg` contains a section labelled `[remote]`, here you should be able to find your `api_key`.
23+
Once you've completed the setup, go to `/boot/config/plugins/dynamix/dynamix.cfg` contains a section labelled `[remote]`, here you should be able to find your `api_key`.
1324

1425
```ini
1526
[remote]
1627
apikey="c53a2R6c4A54043N4f4a65D4ba9fO103fbM491112Aa1519Padc7I2b735Ka768eE614d2Ydfbf7"
1728
```
1829

19-
Copy this into your Home Assistant config along with the URL to your UnRAID installation
20-
```yaml
21-
unraid:
22-
- host: http://192.168.0.10/
23-
api_key: c53a2R6c4A54043N4f4a65D4ba9fO103fbM491112Aa1519Padc7I2b735Ka768eE614d2Ydfbf7
24-
```
30+
Go to your Home Assistance installation and setup a new integration. Find unraid in the list and enter the URL to your installation and the API Key found in the file above.
31+
32+
## Contributions are welcome!
33+
34+
If you want to contribute to this please read the [Contribution guidelines](CONTRIBUTING.md)

info.md

+34
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
# homeassistant-unraid
2+
3+
![GitHub](https://img.shields.io/github/license/jiminald/unraid)
4+
[![hacs_badge](https://img.shields.io/badge/HACS-Custom-orange.svg)](https://github.com/custom-components/hacs)
5+
6+
This is a custom component for [Home Assistant](http://home-assistant.io) that adds [UnRAID](http://unraid.net) data as a sensor to HA.
7+
8+
This component uses a GraphQL API component for a under development module [unraid.net](https://github.com/limetech/Unraid.net)
9+
10+
Tested on Unraid 6.8
11+
12+
## Setup
13+
14+
First, you will need to install the unraid.net plugin onto your unraid instance [https://github.com/limetech/Unraid.net/blob/next/Unraid.net.plg](https://github.com/limetech/Unraid.net/blob/next/Unraid.net.plg)
15+
16+
This will add a new section to your Settings > Management Access titled unraid.net. Register your instance using your unraid.net forum account.
17+
18+
Now SSH into your unraid installation and run the following command
19+
`/etc/rc.d/rc.unraid-api start`
20+
21+
## Config
22+
23+
Once you've completed the setup, go to `/boot/config/plugins/dynamix/dynamix.cfg` contains a section labelled `[remote]`, here you should be able to find your `api_key`.
24+
25+
```ini
26+
[remote]
27+
apikey="c53a2R6c4A54043N4f4a65D4ba9fO103fbM491112Aa1519Padc7I2b735Ka768eE614d2Ydfbf7"
28+
```
29+
30+
Go to your Home Assistance installation and setup a new integration. Find unraid in the list and enter the URL to your installation and the API Key found in the file above.
31+
32+
## Contributions are welcome!
33+
34+
If you want to contribute to this please read the [Contribution guidelines](CONTRIBUTING.md)

0 commit comments

Comments
 (0)