Skip to content

Commit 5a677b2

Browse files
committed
README
1 parent f64bfeb commit 5a677b2

File tree

3 files changed

+98
-2
lines changed

3 files changed

+98
-2
lines changed

README.md

+68-2
Original file line numberDiff line numberDiff line change
@@ -3,9 +3,13 @@
33
</a>AnyAppStart</h1>
44
<br/>
55

6-
`Start/Stop/Restart/View Logs` for Docker, Systemd, SSH, VMs and anything else
6+
Universal app to `Start`/`Stop`/`Restart`/`View Logs` for any Type of service (Docker, Systemd, VMs, remote, user scripts)
77

8-
![Screenshot](https://raw.githubusercontent.com/aceberg/AnyAppStart/refs/heads/main/assets/Screenshot_00.png)
8+
- Backend: `Go`, Frontend: `React`, `TypeScript`, `MobX`
9+
- Small lightweight app, easy to set up and configure
10+
- User can create own types (like LXC or WakeOnLAN)
11+
12+
![Screenshot](https://raw.githubusercontent.com/aceberg/AnyAppStart/refs/heads/main/assets/Screenshot_05.png)
913

1014
## More screenshots
1115
<details>
@@ -17,3 +21,65 @@
1721

1822
</details>
1923

24+
## Install
25+
<details>
26+
<summary>Expand</summary>
27+
28+
> :warning: **Warning**
29+
> 1. There is Docker image available, but inside the container only Docker Type will work, which kinda defeats the purpose of this app. So installing binary is recommended.
30+
> 2. There is no built-in auth in this app, so make sure to restrict access to it with firewall and/or SSO (Authelia) or simple [ForAuth](https://github.com/aceberg/ForAuth)
31+
32+
### Binary
33+
All binary packages can be found in [latest](https://github.com/aceberg/AnyAppStart/releases/latest) release. There are `.deb`, `.rpm`, `.apk` (Alpine Linux) and `.tar.gz` files.
34+
35+
Supported architectures: `amd64`, `i386`, `arm_v5`, `arm_v6`, `arm_v7`, `arm64`.
36+
37+
For `amd64` there is a `deb` repo [available](https://github.com/aceberg/ppa)
38+
39+
### Docker
40+
For demo purpose, mostly.
41+
```sh
42+
docker run --name AnyAppStart \
43+
-e "TZ=$YOURTIMEZONE" \
44+
-v ~/.dockerdata/AnyAppStart:/data/AnyAppStart \
45+
-v /var/run/docker.sock:/var/run/docker.sock \
46+
-p 8855:8855 \
47+
aceberg/anyappstart
48+
```
49+
50+
</details>
51+
52+
## Config
53+
<details>
54+
<summary>Expand</summary>
55+
56+
| Variable | Description | Default |
57+
| -------- | ----------- | ------- |
58+
| TZ | Set your timezone for correct time | |
59+
| HOST | Listen address | 0.0.0.0 |
60+
| PORT | Port for web GUI | 8855 |
61+
| THEME | Any theme name from https://bootswatch.com in lowcase or [additional](https://github.com/aceberg/aceberg-bootswatch-fork) | minty |
62+
| COLOR | Background color: light or dark | dark |
63+
| NODEPATH | Path to local node modules | |
64+
</details>
65+
66+
## Options
67+
<details>
68+
<summary>Expand</summary>
69+
70+
| Key | Description | Default | Systemd (root) | Systemd (user) |
71+
| -------- | ----------- | ------- | ------- | ------- |
72+
| -d | Path to config dir | /data/AnyAppStart | /etc/AnyAppStart | ~/.config/AnyAppStart |
73+
| -n | Path to node modules | | | |
74+
75+
</details>
76+
77+
## Thanks
78+
<details>
79+
<summary>Expand</summary>
80+
81+
- All go packages listed in [dependencies](https://github.com/aceberg/DiaryMD/network/dependencies)
82+
- Favicon and logo: [Flaticon](https://www.flaticon.com)
83+
- [Bootstrap](https://getbootstrap.com/)
84+
85+
</details>

assets/Screenshot_05.png

111 KB
Loading

example/types.yaml

+30
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
Docker:
2+
Logs: docker logs $ITEMNAME
3+
Restart: docker restart $ITEMNAME
4+
Start: docker start $ITEMNAME
5+
State: docker ps --filter status=running | grep $ITEMNAME
6+
Stop: docker stop $ITEMNAME
7+
Systemd:
8+
Logs: sudo systemctl status $ITEMNAME
9+
Restart: sudo systemctl restart $ITEMNAME
10+
Start: sudo systemctl start $ITEMNAME
11+
State: sudo systemctl | grep running | grep $ITEMNAME
12+
Stop: sudo systemctl stop $ITEMNAME
13+
VM:
14+
Logs: sudo journalctl -u libvirtd.service
15+
Restart: sudo virsh rebool $ITEMNAME
16+
Start: sudo virsh start $ITEMNAME
17+
State: sudo virsh list --state-running | grep $ITEMNAME
18+
Stop: sudo virsh shutdown $ITEMNAME
19+
ssh-Docker:
20+
Logs: ssh remote-host-ip -f docker logs $ITEMNAME
21+
Restart: ssh remote-host-ip -f docker restart $ITEMNAME
22+
Start: ssh remote-host-ip -f docker start $ITEMNAME
23+
State: ssh remote-host-ip -f docker ps --filter status=running | grep $ITEMNAME
24+
Stop: ssh remote-host-ip -f docker stop $ITEMNAME
25+
ssh-Systemd:
26+
Logs: ssh remote-host-ip -f sudo systemctl status $ITEMNAME
27+
Restart: ssh remote-host-ip -f sudo systemctl restart $ITEMNAME
28+
Start: ssh remote-host-ip -f sudo systemctl start $ITEMNAME
29+
State: ssh remote-host-ip -f sudo systemctl | grep running | grep $ITEMNAME
30+
Stop: ssh remote-host-ip -f systemctl stop $ITEMNAME

0 commit comments

Comments
 (0)