updated readme + travis. Also addresses #53
This commit is contained in:
parent
929681911a
commit
46299bef76
2 changed files with 60 additions and 16 deletions
|
@ -3,7 +3,7 @@ services:
|
||||||
|
|
||||||
script:
|
script:
|
||||||
- docker build -t boerderij/varken:$TRAVIS_BRANCH .
|
- docker build -t boerderij/varken:$TRAVIS_BRANCH .
|
||||||
- docker ps -a
|
- docker images
|
||||||
- echo "$DOCKER_PASSWORD" | docker login -u "$DOCKER_USERNAME" --password-stdin
|
- echo "$DOCKER_PASSWORD" | docker login -u "$DOCKER_USERNAME" --password-stdin
|
||||||
- docker push boerderij/varken:$TRAVIS_BRANCH
|
- docker push boerderij/varken:$TRAVIS_BRANCH
|
||||||
|
|
||||||
|
|
74
README.md
74
README.md
|
@ -1,7 +1,7 @@
|
||||||
# Varken
|
# Varken
|
||||||
|
[](https://travis-ci.org/Boerderij/Varken)
|
||||||
[](https://discord.gg/AGTG44H)
|
[](https://discord.gg/AGTG44H)
|
||||||
[](https://www.buymeacoffee.com/varken)
|
[](https://www.buymeacoffee.com/varken)
|
||||||
[](https://hub.docker.com/r/boerderij/varken/)
|
|
||||||
|
|
||||||
Dutch for PIG. PIG is an Acronym for Plex/InfluxDB/Grafana
|
Dutch for PIG. PIG is an Acronym for Plex/InfluxDB/Grafana
|
||||||
|
|
||||||
|
@ -12,28 +12,47 @@ frontend
|
||||||
Requirements:
|
Requirements:
|
||||||
* Python3.6+
|
* Python3.6+
|
||||||
* Python3-pip
|
* Python3-pip
|
||||||
|
* InfluxDB
|
||||||
|
|
||||||
<p align="center">
|
<p align="center">
|
||||||
<img width="800" src="https://i.imgur.com/av8e0HP.png">
|
<img width="800" src="https://i.imgur.com/av8e0HP.png">
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
## Quick Setup
|
## Quick Setup (Git Clone)
|
||||||
1. Clone the repository `sudo git clone https://github.com/Boerderij/Varken.git /opt/Varken`
|
```
|
||||||
1. Follow the systemd install instructions located in `varken.systemd`
|
# Clone the repository
|
||||||
1. Create venv in project `cd /opt/Varken && /usr/bin/python3 -m venv varken-venv`
|
git clone https://github.com/Boerderij/Varken.git /opt/Varken
|
||||||
1. Install requirements `/opt/Varken/varken-venv/bin/python -m pip install -r requirements.txt`
|
|
||||||
1. Make a copy of `varken.example.ini` to `varken.ini` in the `data` folder
|
|
||||||
`cp /opt/Varken/data/varken.example.ini /opt/Varken/data/varken.ini`
|
|
||||||
1. Make the appropriate changes to `varken.ini`
|
|
||||||
ie.`nano /opt/Varken/data/varken.ini`
|
|
||||||
1. Make sure all the files have the appropriate permissions `sudo chown varken:varken -R /opt/Varken`
|
|
||||||
1. After completing the [getting started](http://docs.grafana.org/guides/getting_started/) portion of grafana, create your datasource for influxdb.
|
|
||||||
1. Install `grafana-cli plugins install grafana-worldmap-panel`
|
|
||||||
|
|
||||||
|
# Follow the systemd install instructions located in varken.systemd
|
||||||
|
nano /opt/Varken/varken.systemd
|
||||||
|
cp /opt/Varken/varken.systemd /etc/systemd/system/varken.service
|
||||||
|
|
||||||
|
# Create venv in project
|
||||||
|
/usr/bin/python3 -m venv /opt/Varken/varken-venv
|
||||||
|
|
||||||
|
# Install requirements
|
||||||
|
/opt/Varken/varken-venv/bin/python -m pip install -r requirements.txt
|
||||||
|
|
||||||
|
# Make a copy of varken.example.ini to varken.ini in the data folder
|
||||||
|
cp /opt/Varken/data/varken.example.ini /opt/Varken/data/varken.ini
|
||||||
|
|
||||||
|
# Make the appropriate changes to varken.ini
|
||||||
|
nano /opt/Varken/data/varken.ini
|
||||||
|
|
||||||
|
# Make sure all the files have the appropriate permissions
|
||||||
|
chown $USER:$USER -R /opt/Varken
|
||||||
|
|
||||||
|
# Start the service and enable it
|
||||||
|
systemctl start varken
|
||||||
|
systemctl enable varken
|
||||||
|
```
|
||||||
### Docker
|
### Docker
|
||||||
|
|
||||||
Repo is included in [Boerderij/docker-Varken](https://github.com/Boerderij/docker-Varken)
|
Repo is included in [Boerderij/docker-Varken](https://github.com/Boerderij/docker-Varken)
|
||||||
|
[](https://microbadger.com/images/boerderij/varken")
|
||||||
|
[](https://microbadger.com/images/boerderij/varken")
|
||||||
|
[](https://hub.docker.com/r/boerderij/varken/)
|
||||||
|
[](https://hub.docker.com/r/boerderij/varken/)
|
||||||
<details><summary>Example</summary>
|
<details><summary>Example</summary>
|
||||||
<p>
|
<p>
|
||||||
|
|
||||||
|
@ -42,7 +61,32 @@ docker run -d \
|
||||||
--name=varken \
|
--name=varken \
|
||||||
-v <path to data>:/config \
|
-v <path to data>:/config \
|
||||||
-e PGID=<gid> -e PUID=<uid> \
|
-e PGID=<gid> -e PUID=<uid> \
|
||||||
boerderij/varken:nightly
|
boerderij/varken
|
||||||
```
|
```
|
||||||
</p>
|
</p>
|
||||||
</details>
|
</details>
|
||||||
|
|
||||||
|
#### Tags
|
||||||
|
* **latest**
|
||||||
|
* **nightly**
|
||||||
|
* **release-tag** e.g. v1.0
|
||||||
|
|
||||||
|
#### Upgrading with docker
|
||||||
|
```sh
|
||||||
|
docker stop varken
|
||||||
|
docker rm varken
|
||||||
|
# Run deploy command above
|
||||||
|
```
|
||||||
|
|
||||||
|
### InfluxDB
|
||||||
|
[InfluxDB Installation documentation](https://docs.influxdata.com/influxdb/v1.7/introduction/installation/)
|
||||||
|
Influxdb is required but not packaged as part of Varken. Varken will create
|
||||||
|
its database on its own. If you choose to give varken user permissions that
|
||||||
|
do not include database creation, please ensure you create an influx database
|
||||||
|
named `varken`
|
||||||
|
|
||||||
|
### Grafana
|
||||||
|
Grafana is used in our examples but not required, nor packaged as part of
|
||||||
|
Varken. Panel example pictures are pinned in the grafana-panels channel of
|
||||||
|
discord. Future releases may contain a json-generator, but it does not exist
|
||||||
|
as varken stands today.
|
Loading…
Reference in a new issue