diff --git a/docs/user/add-new-service.md b/docs/user/add-new-service.md
index 6a4056f..1c901bd 100644
--- a/docs/user/add-new-service.md
+++ b/docs/user/add-new-service.md
@@ -27,7 +27,7 @@ agebd service add --help
 clean working tree, then it:
 
 1. Assigns the service the next free IOC port and registers it in
-   [`config/services_registry.yml`](../../config/services_registry.yml).
+   [`config/services_registry.yml`](https://gitea.psi.ch/sls/hla_framework_bd/src/branch/main/config/services_registry.yml).
 2. Adds the service to `AGEBD-CPCL-MASTER`'s IOC pattern file, so it gets the standard
    ALH lifecycle PVs (`AGEBD-ALH$(SUFFIX):$(SERVICE)-*`) and appears in the `ServiceManager`
    GUI screen.
diff --git a/docs/user/gui.md b/docs/user/gui.md
index b05ed00..908a51d 100644
--- a/docs/user/gui.md
+++ b/docs/user/gui.md
@@ -2,24 +2,24 @@
 
 ## Launch
 
-```
-cd <repo-root>
-```
-
 In `prod`:
+`ssh sls-vserv-bd-hla01`
 ```
-./bin/sls_hla_launch_gui.sh qt/A_BD_InjectionGuard.ui
+cd /sls/bd/hla/prod/qt
+../bin/sls_hla_launch_gui.sh A_BD_ServiceManager.ui
 ```
 
 In `dev`:
+`ssh sls-vserv-bd-hla01-dev`
 ```
-./bin/sls_hla_launch_gui.sh qt/A_BD_InjectionGuard.ui dev
+cd /sls/bd/hla/dev/qt
+../bin/sls_hla_launch_gui.sh A_BD_ServiceManager.ui "dev"
 ```
 
 Any extra arguments are passed straight through to `caqtdm`, e.g. to set a macro:
 
 ```
-./bin/sls_hla_launch_gui.sh qt/A_BD_Tune.ui dev -macro "OTHER_ENV_VAR=HEYHEY"
+../bin/sls_hla_launch_gui.sh A_BD_ServiceManager.ui "dev" -macro "OTHER_ENV_VAR=HEYHEY"
 ```
 
 **Note:** launching straight from a git checkout, as above, uses the raw `.ui` files as
diff --git a/docs/user/ioc/iocs_overview.md b/docs/user/ioc/iocs_overview.md
index c0e567c..f51a793 100644
--- a/docs/user/ioc/iocs_overview.md
+++ b/docs/user/ioc/iocs_overview.md
@@ -1,6 +1,6 @@
 # Overview of IOCs for Beam Dynamics
 
-The ports are configured in the [service registry](../../../config/services_registry.yml)
+The ports are configured in the [service registry](https://gitea.psi.ch/sls/hla_framework_bd/src/branch/main/config/services_registry.yml)
 
 | IOC NAME | Description |
 |---|---|