Install On Target¶

Install trust-runtime as a service on Raspberry Pi or another small Linux target.

Raspberry Pi Quick Path¶

The supported public-doc path is: download the latest release, install trust-runtime, install the service unit, reboot, and confirm the Pi auto-starts the runtime.

1. Download The Released Runtime Bundle¶

Start from the latest GitHub release:

https://github.com/johannesPettersson80/trust-platform/releases/latest

For Raspberry Pi and other ARM64 Linux targets, download the Linux ARM64 runtime bundle. The release bundle is the supported install path.

2. Install The Runtime¶

Copy the downloaded bundle to the target and unpack it:

mkdir -p /opt/trust/releases/runtime
tar -xzf trust-runtime-linux-arm64.tar.gz -C /opt/trust/releases/runtime

Install the runtime binary somewhere stable on PATH:

sudo install -m 0755 /opt/trust/releases/runtime/trust-runtime /usr/local/bin/trust-runtime
sudo install -m 0755 /opt/trust/releases/runtime/trust-bundle-gen /usr/local/bin/trust-bundle-gen

3. Install Your Project¶

Create the deployment root and place your project there:

sudo mkdir -p /opt/trust/current
sudo chown -R "$USER":"$USER" /opt/trust

Your deployed project should contain at least:

runtime.toml
io.toml
program.stbc

4. Install The systemd Unit¶

The repo ships a service file at docs/deploy/systemd/trust-runtime.service.

For PREEMPT_RT deployments, use the dedicated template instead:

Install it:

sudo cp docs/deploy/systemd/trust-runtime.service /etc/systemd/system/trust-runtime.service
sudo systemctl daemon-reload
sudo systemctl enable trust-runtime
sudo systemctl start trust-runtime

If this target is meant to run under PREEMPT_RT, copy the RT template as the service unit instead of the baseline file and configure [runtime.realtime] in runtime.toml.

5. Verify Boot And Runtime Health¶

Confirm the service is up now:

systemctl status trust-runtime --no-pager
journalctl -u trust-runtime -n 100 --no-pager

Then reboot the target and verify it auto-starts again:

sudo reboot

After the host comes back:

systemctl status trust-runtime --no-pager

Log Location¶

systemd journal: journalctl -u trust-runtime
your project/runtime logs, if configured, follow the paths from runtime.toml