From 48ce2db2281afe08d44fb10c5ff15ce186b7f358 Mon Sep 17 00:00:00 2001
From: Benjamin Labrecque <labrecque.benji@gmail.com>
Date: Tue, 25 Aug 2026 11:59:10 +0200
Subject: [PATCH] docs: setup vserv machine

---
 docs/developer/cicd_runner.md | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/docs/developer/cicd_runner.md b/docs/developer/cicd_runner.md
index 3aa8da0..06b0d9b 100644
--- a/docs/developer/cicd_runner.md
+++ b/docs/developer/cicd_runner.md
@@ -184,3 +184,28 @@ The gitea actions run as user `svcusr-sls2hla`
 ### #TODO: this is a temporary workaround
 I created an ssh key on `sls-vserv-bd-hla01-dev` (where the runner runs), and added the public key to my
 gitea profile ssh keys. That way the `svcusr` can clone the repos I can clone.
+
+
+## Setup `sls-vserv-bd-01-dev`
+
+On `sls-vserv-bd-hla01-dev`
+
+```
+sudo su - svcusr-sls2hla
+cat ~/.ssh/id_ed25519.pub
+```
+
+If it does not exist yet:
+```
+sudo su - svcusr-sls2hla
+ssh-keygen -t ed25519 -N "" -C "svcusr-sls2hla@sls-vserv-bd-hla01-dev" -f ~/.ssh/id_ed25519
+cat ~/.ssh/id_ed25519.pub
+```
+
+```
+ssh sls-vserv-bd-01-dev            # lands as your own user
+sudo install -d -m 700 -o svcusr-sls2hla -g unx-nogroup /home/svcusr-sls2hla /home/svcusr-sls2hla/.ssh
+echo '<paste the pubkey>' | sudo tee /home/svcusr-sls2hla/.ssh/authorized_keys
+sudo chown svcusr-sls2hla:unx-nogroup /home/svcusr-sls2hla/.ssh/authorized_keys
+sudo chmod 600 /home/svcusr-sls2hla/.ssh/authorized_keys
+```