Start9/documentation
2
0
Fork 0
mirror of https://github.com/Start9Labs/documentation.git synced 2026-03-30 04:01:59 +00:00
Code Issues Packages Projects Releases Wiki Activity

Dev tools init, config edits, misc edits

Browse Source
This commit is contained in:
kn0wmad
2022-01-16 00:28:31 -07:00
committed by Lucy Cifferello
parent 5c10c17204
commit a5fe40e84a
19 changed files with 286 additions and 82 deletions
Download Patch File Download Diff File Expand all files Collapse all files

19
site/source/support/dev-docs/dev-tools/service-container.rst Normal file
View File

@@ -0,0 +1,19 @@
.. _service-container:
=========================
Enter a Service Container
=========================
For simplicity, EmbassyOS is designed to be completely operated via the :ref:`WebUI<web-ui>`, however, your device belongs to you and if you want to "lift the hood" and access the internals of the software, you may do so. This guide will show you how to enter a Service's :ref:`container<containers>` in order to directly interface with it and issue commands.
.. warning:: The following guide is for those that have advanced command line skills, or those who are being guided by a Start9 support technician. Nothing you do inside a container is supported unless under the direction of Start9. Here be dragons!!
This guide assumes you already have :ref:`SSH Access<ssh-setup>` setup on your machine.
Open a terminal, ssh into your device, and enter the following command, replacing ``<SERVICE>`` with the name of the service you are trying to access. You can list the services with ``embassy-cli package list`` (you will need to be logged in under ``embassy-cli`` for this). You will need to either be ``root`` or use ``sudo``.
.. code-block:: bash
docker exec -it <SERVICE>.embassy sh
This will give you a shell within the container. Reminder that nothing you do in here is supported, please be careful!