aboutsummaryrefslogtreecommitdiff
path: root/site
diff options
context:
space:
mode:
authorOmar Polo <op@omarpolo.com>2021-10-04 12:56:11 +0000
committerOmar Polo <op@omarpolo.com>2021-10-04 12:56:11 +0000
commiteb82dcfbf4a4013f0ad3ba359c32c79c87953e25 (patch)
tree5a8b806305030874f735612919929489ee710ec0 /site
parent12866f1911ebefc40cf4f988cd59d620e8b50a96 (diff)
improve the service file usage instructions
Thanks Martin for providing these information :)
Diffstat (limited to 'site')
-rw-r--r--site/contrib.gmi14
-rw-r--r--site/contrib.html11
2 files changed, 19 insertions, 6 deletions
diff --git a/site/contrib.gmi b/site/contrib.gmi
index 4f453a0..fa0772f 100644
--- a/site/contrib.gmi
+++ b/site/contrib.gmi
@@ -45,8 +45,18 @@ A simple service file for systemd. To install it
then the usual ‘systemctl [status|start|enable|stop] gmid’ commands can be used to manage the server.
Some things to keep in mind:
-* the ExecStart path depends on the installation
-* decomment “User” and “Group” to start gmid without root priviledges. It’s not needed, since gmid can lower its privileges, but may come in handy.
+* the ExecStart path may depend on the installation
+* a ‘gmid’ user needs to be create for e.g. with
+
+```how to create a dedicated user
+# useradd --system --no-create-home -s /bin/nologin -c "gmid Gemini server" gmid
+```
+
+* logs can be inspected with journalctl(1)
+
+```reads gmid logs with journalctl
+# journalctl -t gmid
+```
## Vim syntax files
diff --git a/site/contrib.html b/site/contrib.html
index c9b5c2f..3d10296 100644
--- a/site/contrib.html
+++ b/site/contrib.html
@@ -182,12 +182,15 @@
<p>Some things to keep in mind:</p>
<ul>
<li>
- the <code>ExecStart</code> path depends on the installation.
+ the <code>ExecStart</code> path may depend on the installation.
</li>
<li>
- decomment <code>User</code> and <code>Group</code> to start
- gmid without root priviledges. It's not needed, since gmid
- can lower its privileges, but may come in handy.
+ a <code>gmid</code> user needs to be created for e.g. with:
+ <pre># useradd --system --no-create-home -s /bin/nologin -c "gmid Gemini server" gmid</pre>
+ </li>
+ <li>
+ logs can be inspected with <code>journalctl(1)</code>:
+ <pre># journalctl -t gmid</pre>
</li>
</ul>
<h2 id="vim-syntax-files">Vim syntax files</h2>