Skip to content

Commit 8b5f79b

Browse files
authored
Merge pull request #14 from epics-containers/dev
update running outside of K8S
2 parents 48bbd58 + 792cfb5 commit 8b5f79b

File tree

1 file changed

+9
-2
lines changed

1 file changed

+9
-2
lines changed

docs/user/how-to/run_iocs.rst

Lines changed: 9 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -17,11 +17,18 @@ will see the IOC running in a container:
1717

1818
.. code-block:: bash
1919
20-
podman run -it -v $(pwd)/iocs/bl01t-ea-ioc-01/config:/repos/epics/ioc/config ghcr.io/epics-containers/ioc-template-linux-runtime:23.3.3
20+
podman run --net host -it --rm -v $(pwd)/iocs/bl01t-ea-ioc-01/config:/repos/epics/ioc/config ghcr.io/epics-containers/ioc-template-linux-runtime:23.3.3
2121
2222
What you have done here is pull down the generic ``ioc-template-linux-runtime``
2323
container image from the GitHub Container Registry and run it.
24-
The -it means it is an interactive terminal session.
24+
The ``-it`` means it is an interactive terminal session. ``--rm`` means the
25+
container is removed when it exits, best for keeping your cache tidy.
26+
Note that you could also add ``-d`` to run the container in the background,
27+
you could then attach to it with the ``podman attach`` command.
28+
29+
The ``--net host`` means the container will use the same network namespace as
30+
the host. This is required because channel access protocol does not
31+
travel through a NAT to a container network (See `../explanations/net_protocols`)
2532

2633
The -v mounts the local directory ``iocs/bl01t-ea-ioc-01/config`` into the
2734
container at ``/repos/epics/ioc/config``. This is where the IOC expects to

0 commit comments

Comments
 (0)