RemoteSystemctl/README.md

43 lines
902 B
Markdown

# Remote control for systemctl --user start/stop
## Install
### Add systemctl service
Add a user service:
`$HOME/.config/systemd/user/default.target.wants/remotesystemctl.service`
```
[Unit]
Description=RemoteSystemctl
Documentation=
[Service]
ExecStart=$HOME/RemoteSystemctl/app.rb
Restart=on-failure
RestartSec=5
WorkingDirectory=$HOME/RemoteSystemctl
[Install]
WantedBy=default.target
```
Enable it at reboot
`systemctl --user enable remotesystemctl.service`
Start it right now
`systemctl --user start remotesystemctl.service`
### Configure
Copy `.env.sample` to `.env.local` and customize.
You can add/remove services using their exact name with PASSWORD_xxx env variables.
### Setup ruby
Have `ruby >= 3.1` installed with `gems` and the `bundler` gem.
Then simply use `bundle install` to install the dependencies (see the `Gemfile`, there should a very low amount of dependencies).