2019-01-26 09:39:02 +00:00
# README
2022-09-17 18:28:53 +00:00
system-helpers is a collection of helper systemd services, systemd timers and
2022-06-13 09:31:59 +00:00
shell scripts for common configuration and tasks like
2019-01-26 09:39:02 +00:00
2022-06-13 09:31:59 +00:00
* checking if systemd services and timers are running
* borgmatic backup
* restic backup
* checking if docker containers are running
* batch docker-compose upgrades
* docker housekeeping for removing unused docker containers, volumes and images
* dynamic dns update
* update check for pacman
* memory and disk checks
Provided systemd services mostly support mail notifications if they have failed
via systemd_failure_notify.
2022-09-17 18:28:53 +00:00
See `/usr/share/doc/system-helpers` for example configurations which should
2022-06-13 09:31:59 +00:00
be copied inside $HOME or /etc depending on the helper script.
2022-06-13 00:21:33 +00:00
## Installation
2022-07-11 20:35:41 +00:00
1. Build a `pacman` package for ArchLinux via `makepkg -csi` inside the `_pkg/` folder
2. Alternatively, use `./sync` from the git clone and pick an action which should be self-explaining
2022-07-11 20:29:51 +00:00
3. Use the custom provided ArchLinux repository hosted at `aur.myservermanager.com`
```shell
[repo-aur-myservermanager-com]
SigLevel = Never
2022-07-11 20:49:31 +00:00
Server = https://aur.myservermanager.com
2022-07-11 20:29:51 +00:00
```
2022-06-13 00:21:33 +00:00
## Usage
2019-01-26 09:39:02 +00:00
2021-12-27 10:24:05 +00:00
Services and scripts don't depend on each other but have hints that they can be
combined (out-commented line in service files for `systemd_failure_notify@.service`
for example).
2019-01-26 09:39:02 +00:00
2022-09-17 18:28:53 +00:00
Examples are given inside `usr/share/doc/system-helpers` .
2022-06-13 00:21:33 +00:00
## FAQ
2021-12-27 10:24:05 +00:00
2022-06-13 00:21:33 +00:00
### User cannot use network-online.target
2021-12-27 10:24:05 +00:00
By default, no user unit can depend on system events like `network-online.target` .
To enable this, you need to link the proper `.target` which you like to use inside
the user service before.
2022-06-13 00:21:33 +00:00
```shell
2021-12-27 10:24:05 +00:00
systemctl --user link /usr/lib/systemd/system/network-online.target
```
2022-08-23 16:55:27 +00:00
This would make `network-online.target` available after a _reboot_ to the user who issued the command.
### `network-online.target` doesn't recognize DNS correctly
If you like to set `Persistent=true` , then you should probably equip the related `.service` file with a `ExecStartPre=/bin/bash -c 'until host captiveportal.myservermanager.com; do sleep 1; done'` or any domain you think is 100% reachable.
