From f39dfeee6955df37643d851196da06e98e3579d5 Mon Sep 17 00:00:00 2001
From: Benjamin Labrecque <labrecque.benji@gmail.com>
Date: Thu, 16 Jul 2026 11:07:38 +0200
Subject: [PATCH] docs: add existing ioc docs

---
 docs/ioc/ioc.md | 37 +++++++++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)

diff --git a/docs/ioc/ioc.md b/docs/ioc/ioc.md
index f013673..b76be4a 100644
--- a/docs/ioc/ioc.md
+++ b/docs/ioc/ioc.md
@@ -51,3 +51,40 @@ Exit:
 ```shell
 Ctrl + d
 ```
+
+Old docs: # TODO: merge with current
+
+## IOC installation
+The following instructions explain the basics of starting and managing IOCs on the IOC host. 
+For the initial install the shellbox on the ioc host must be restarted. 
+For existing IOCs a login to the IOC and restart via ctr+x is sufficient.
+
+### local tests
+#### using subs file
+iocsh AGEBD-CPCL-PLAYGROUND_main.subs
+
+#### using template file 
+iocsh PLAYGROUND.template DEVICE=TEST
+
+### proper install
+ioc install -V --ioc AGEBD-CPCL-PLAYGROUND --clean
+
+ioc shell AGEBD-CPCL-PLAYGROUND
+
+ctrl+x
+
+### login on BD IOC host for access to shellbox
+ssh sls-vserv-bd-01
+
+#### shellbox  
+TODO: should be -bd-01?
+cd /ioc/hosts/sls-vserv-op-01<br>
+gedit shellbox.conf<br>
+
+restart ioc via shellbox:<br>
+sudo shellbox reload            # new ioc installed<br>
+sudo shellbox status            # status of all iocs on server<br>
+sudo shellbox stop 50045        # stop ioc<br>
+sudo shellbox start 50045       # start ioc<br>
+sudo shellbox log 50045 -f      # log file (tail)<br>
+exit                            # exit ssh<br>