Running KubOS Core Services Locally¶
This document will lead you through the steps of configuring and running the KubOS core services locally. All of the KubOS core services are capable of being run within your local development environment. This will allow you to get up and running with KubOS before you have an OBC in hand.
The KubOS core services all rely on a central file for run-time configuration information.
In a standard Kubos Linux system, that file will be located at
/home/system/etc/config.toml. As a result, this is the default location
where services will check. When running locally, it is unlikely that file location
will exist, so we will need to create a custom config file and then
manually pass it to the service.
This central configuration file is in the
toml format and contains a section
for each service. Here is a default config
you can use when running the core services. It can be found at
in the Kubos repo folder.
In the config file each service has their own section(s). Any custom configuration for the service will go in a section named after the service:
[service-name] config_option = "value"
Any service which exposes a GraphQL interface will have a separate section for configuring the GraphQL server:
[service-name.addr] ip = "127.0.0.1" port = 8000
All of the KubOS core services require an
.addr section in the configuration file.
A local configuration file will only need config data for the services which you intend to run locally. If you would like to run a hardware service, each existing hardware service provided by Kubos documents their configuration options within their respective pages.
Each service can either be run from the base of the Kubos repo with this command:
$ cargo run --bin service-name -- -c tools/default_config.toml
Or by navigating to the service’s source folder and running this command:
$ cargo run -- -c ../../tools/default_config.toml
These examples point to the default config file provided with the repo with
-- -c tools/default_config.toml, however that path can be
changed to point to a custom config file.