Menu

Managing Services

EmbassyOS provides a rich interface for managing installed Services.

Service Dashboard

The Service Dashboard provides quick insight into the status and health of your service, as well as exposing a variety of management tools.

../_images/service00.png
  • Status:
    • Needs Config: The Service needs your attention in making a configuration decision. There will always be default options available to you.

    • Stopping: Service is in the process of stopping.

    • Stopped: Service is installed and configured, but not currently running.

    • Starting: Service is in the process of starting up.

    • Running: Service is running.

  • Launch UI: If the service offer a User Interface (UI), and the UI is currently available, clicking this button will launch the UI in a new browser tab. Learn more about Web UIs.

  • Health Checks: This is a critical feature of EmbassyOS. Health Checks are configured by the service packager in order to quickly convey to the user what is happening with their service, as well as possible actions they may want to take. Learn more about Health Checks.

  • Dependencies: Some services depend on the presence and proper configuration of other services to function. This section will inform you if all dependencies are satisfied and, if not, what to do about it. Learn more about Dependencies.

  • Start / Stop: Self-explanatory, use these buttons to start or stop a service.

Installing a Service

  • To add a new service, find its listing inside the Marketplace and click “Install”.

    ../_images/service0.png
    ../_images/service1.png
  • Depending on the size of the service and your Internet connection, installation should take between 60 seconds and a few minutes.

    ../_images/service2.png
  • You may click View Service at any time to view install progress.

    ../_images/service3.png

Updating a Service

Note

EmbassyOS will NEVER update a service without your consent.

To see if an update is available for a service, you can visit the Updates section of the Marketplace or by visiting its Marketplace listing.

If an update is available, simply click “Update” and confirm the action.

Configuring a Service

After an installation or update, some services require configuration before they can be started.

Navigate to the Services > [Service Name] > Config

../_images/service-needs-config.png

Traditionally, configuring services was a massive headache and a huge barrier to running a personal server. But no more! The Embassy’s revolutionary service config system makes the process transparent, simple, and safe.

../_images/service4.png

Config options are defined by the service developer and can be almost anything. They are represented as simple UI elements - such as toggles and drop downs - and they include explanations and validations, such that users understand their purpose and are prevented from making mistakes.

../_images/service5.png

You can change your configuration at any time from a Service’s main page:

../_images/config.png

Service Instructions

  • Every services comes with its own set of usage instructions. To view the instructions for a particular service, navigate to the Services > [Service Name] > Instructions.

../_images/instruct.png
  • Instructions will provide you with service-specific direction, provided by the service package developer, on what to expect, and how to use your new service.

../_images/service-instruct.png

Service Properties

Properties can contain both static and dynamic information about a service. They could be almost anything: a default username/password, an invite code, or a list of peers - anything the service developer thought might be useful.

Note

Some services do not have any information in the Properties section.

../_images/props.png
  • To view the Properties for a particular service, navigate to Services > [Service Name] > Properties.

  • Properties may be accompanied by one or more of the following:
    • a help icon for further explanation.

    • a copy icon for copying the value to your clipboard.

    • a QR icon for viewing the value as a QR code.

Service Interfaces

Interfaces are URLs that an installed service uses to communicate in various ways with other software. Many Services will only have one interface, perhaps with a Tor and LAN address, to denote where it is hosted / accessed. Other services, such as Bitcoin or Lightning Nodes, may have several interfaces for different use cases.

../_images/service-ints.png
  • To view the Interfaces for a particular service, navigate to Services > [Service Name] > Properties. From there you can copy a URL to your clipboard for use with external software.

../_images/service-ints0.png

Service Actions

Actions are defined by the service package developer, and can provide the ability to do resets or other miscellaneous administrative tasks. Actions may or may not require user input.

../_images/acts.png

Default Actions

Every service comes with a set up default Actions that can be run. Currently, the only default action is “Uninstall”.

  • Uninstall - To Uninstall a service, navigate to Services > [Service Name] > Actions > Uninstall.

    Warning

    THIS WILL DELETE ALL DATA FOR THIS SERVICE, PLEASE BE SURE YOU WANT TO DO THIS!

Custom Actions

Service developers can define any number of arbitrary actions for their service.

Service logs

Every service emits logs while it is in a running state. Logs give an under-the-hood glimpse of a service and can be extremely useful for debugging purposes. To a non-technical user, logs may look like gibberish, and sometimes there is nothing to see at all. You can check here if you have an issue with a service, and if you are talking to support, they may ask you to screenshot or copy these logs to help discover the root of the problem.

../_images/logs.png
  • To view the Logs for a particular service, go to Services > [Service Name] > Logs