Skip to content

Commit b6b7606

Browse files
committed
update README
1 parent 027f44b commit b6b7606

5 files changed

Lines changed: 133 additions & 37 deletions

File tree

.github/templates/README.template.md

Lines changed: 33 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -31,15 +31,44 @@ Let's use jellyfin for example
3131
{ { file.examples/jellyfin.yaml } }
3232
```
3333

34-
## Usage
34+
### Configuration
3535

36-
Use a Reverse Proxy to redirect you from a service `https://jellyfin.mydomain.com` on another machine to `https://wol-red.mydomain.com`,
37-
WoL Redirect will use the `config.json` to get the host of the requested service.
36+
```json
37+
{ { file.examples/config/mapping.json } }
38+
```
39+
40+
#### PVE (VMs + LXCs)
41+
42+
If you are trying to wakeup a host running PVE, you will probably want to wakeup LXCs or VMs too.
43+
Sadly LXCs (and VMs) don't have `Wake-on-LAN` functionalities.
44+
For that you will need (WoL PVE)[https://github.com/codeshelldev/wol-pve]
45+
46+
```json
47+
{ { file.examples/config/mapping-pve.json } }
48+
```
49+
50+
#### Docker
51+
52+
If you are running docker on your resource-hungry server, you might want to start docker-containers only if needed.
53+
For this to work you will need (WoL Dockerized)[https://github.com/codeshelldev/wol-dockerized]
54+
55+
```json
56+
{ { file.examples/config/mapping-docker.json } }
57+
```
58+
59+
#### Or both
3860

3961
```json
40-
{ { file.config/mapping.json } }
62+
{ { file.examples/config/mapping-pve-docker.json } }
4163
```
4264

65+
_You will need both (WoL PVE)[https://github.com/codeshelldev/wol-pve] and (WoL Dockerized)[https://github.com/codeshelldev/wol-dockerized]_
66+
67+
## Usage
68+
69+
Use a Reverse Proxy to redirect you from a service `https://jellyfin.mydomain.com` on another machine to `https://wol-red.mydomain.com`,
70+
WoL Redirect will use the `config.json` to get the host of the requested service.
71+
4372
## Contributing
4473

4574
## License
Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
{
2+
"hosts": {
3+
"docker-server": {
4+
"ip": "192.168.1.1",
5+
"mac": "XX:XX:XX:XX:XX:XX",
6+
"startupTime": 10
7+
}
8+
},
9+
"routes": {
10+
"docker": {
11+
"route": ["docker-server"],
12+
"attributes": {
13+
"wakeDocker": true
14+
}
15+
}
16+
},
17+
"records": {
18+
"jellyfin.mydomain.com": "docker",
19+
"*.mydomain.com": "docker"
20+
}
21+
}
Original file line numberDiff line numberDiff line change
@@ -1,33 +1,33 @@
1-
{
2-
"hosts": {
3-
"pve": {
4-
"ip": "192.168.1.1",
5-
"mac": "XX:XX:XX:XX",
6-
"startupTime": 40
7-
},
8-
"lxc": {
9-
"ip": "192.168.1.1",
10-
"id": "100",
11-
"startupTime": 10,
12-
"isVirtual": true
13-
},
14-
"ubuntu-vm": {
15-
"ip": "192.168.1.1",
16-
"id": "100",
17-
"startupTime": 10,
18-
"isVirtual": true
19-
}
20-
},
21-
"routes": {
22-
"pve-lxc": {
23-
"route": ["pve", "lxc"],
24-
"attributes": {
25-
"wakeDocker": true
26-
}
27-
}
28-
},
29-
"records": {
30-
"jellyfin.mydomain.com": "pve-lxc",
31-
"*.mydomain.com": "pve-lxc"
32-
}
33-
}
1+
{
2+
"hosts": {
3+
"pve": {
4+
"ip": "192.168.1.1",
5+
"mac": "XX:XX:XX:XX:XX:XX",
6+
"startupTime": 40
7+
},
8+
"lxc": {
9+
"ip": "192.168.1.1",
10+
"id": "100",
11+
"startupTime": 10,
12+
"isVirtual": true
13+
},
14+
"ubuntu-vm": {
15+
"ip": "192.168.1.1",
16+
"id": "100",
17+
"startupTime": 10,
18+
"isVirtual": true
19+
}
20+
},
21+
"routes": {
22+
"pve-lxc": {
23+
"route": ["pve", "lxc"],
24+
"attributes": {
25+
"wakeDocker": true
26+
}
27+
}
28+
},
29+
"records": {
30+
"jellyfin.mydomain.com": "pve-lxc",
31+
"*.mydomain.com": "pve-lxc"
32+
}
33+
}

examples/config/mapping-pve.json

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
{
2+
"hosts": {
3+
"pve": {
4+
"ip": "192.168.1.1",
5+
"mac": "XX:XX:XX:XX:XX:XX",
6+
"startupTime": 40
7+
},
8+
"lxc": {
9+
"ip": "192.168.1.1",
10+
"id": "100",
11+
"startupTime": 10,
12+
"isVirtual": true
13+
},
14+
"ubuntu-vm": {
15+
"ip": "192.168.1.1",
16+
"id": "100",
17+
"startupTime": 10,
18+
"isVirtual": true
19+
}
20+
},
21+
"routes": {
22+
"pve-lxc": {
23+
"route": ["pve", "lxc"]
24+
}
25+
},
26+
"records": {
27+
"*.mydomain.com": "pve-lxc"
28+
}
29+
}

examples/config/mapping.json

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
{
2+
"hosts": {
3+
"server-1": {
4+
"ip": "192.168.1.1",
5+
"mac": "XX:XX:XX:XX:XX:XX",
6+
"startupTime": 40
7+
}
8+
},
9+
"routes": {
10+
"server-1": {
11+
"route": ["server-1"]
12+
}
13+
},
14+
"records": {
15+
"*.mydomain.com": "server-1"
16+
}
17+
}

0 commit comments

Comments
 (0)