summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorPjotr Prins2022-10-08 12:07:56 -0500
committerPjotr Prins2022-10-08 12:07:56 -0500
commit1066a1053c6d6f4d2b09f086226b4388c951d914 (patch)
tree8998d871dc827e7309d274e8b1cd00b6152c5722
parent0105391c4cddc9dad5affd98dab3edcce35752f1 (diff)
downloadgn-gemtext-1066a1053c6d6f4d2b09f086226b4388c951d914.tar.gz
shepherd: add info
-rw-r--r--topics/systems/shepherd.gmi36
1 files changed, 32 insertions, 4 deletions
diff --git a/topics/systems/shepherd.gmi b/topics/systems/shepherd.gmi
index ea5f10b..d67d9d6 100644
--- a/topics/systems/shepherd.gmi
+++ b/topics/systems/shepherd.gmi
@@ -2,15 +2,42 @@
## Tags
-* assigned: ??
+* assigned: pjotrp, efraimf
* type: documentation
* keywords: system, shepherd
-* status: unclear
+* status: wip
* priority: unclear
## Description
-On Debian based systems we run shepherd as a shepherd user. The service gets started up through systemd:
+On Debian based systems we run shepherd as a shepherd user. The service gets started up through systemd.
+There is currently a systemd service to automatically start shepherd
+on system boot-up. A copy of the service lives in the shepherd-service
+repository.
+
+The process for deploying the services:
+
+symlink shepherd-services/shepherd to $HOME/.config/shepherd
+symlink shepherd-services/cron to $home/.config/cron
+symlink shepherd-services/*sh to $HOME
+
+When shepherd starts up it should start all the services. So currently
+that's bnw, gitea, ipfs, power, rn6app, singlecell and the mcron
+services, gitea-dump and pubmed.
+
+To use shepherd's herd command the command is 'sudo -u shepherd
+/home/shepherd/.guix-profile/bin/herd status'.
+
+: /home/shepherd/.guix-profile/bin/herd status
+
+Adding a bash alias, such as "alias herd-herd='sudo -u shepherd
+/home/shepherd/.guix-profile/bin/herd'", will make it easier to
+interact with shepherd without needing to switch to the shepherd
+user. The logs for the various shepherd services are located in
+/home/shepherd/logs/ but are not yet timestamped. The log for shepherd
+itself is in /home/shepherd/.config/shepherd/shepherd.log. There is
+not yet a way to change this from a config file.
+
```
[Unit]
@@ -31,4 +58,5 @@ WantedBy=multi-user.target
## Notes
-This seems to be documentation, and not necessarily a task, issue or enhancement to be worked on
+This seems to be documentation, and not necessarily a task, issue or enhancement to be worked on.
+It is a topic.