Wrapper for hello-world

hello-world is a simple, minimal project to serve as a template for creating an app for the Embassy. Learn more about service packaging in Developer Docs.

Dependencies

• docker
• docker-buildx
• yq
• deno
• make
• embassy-sdk

Build enviroment

Prepare your EmbassyOS build enviroment. In this example we are using Ubuntu 20.04.

1. Install docker

curl -fsSL https://get.docker.com -o- | bash
sudo usermod -aG docker "$USER"
exec sudo su -l $USER

2. Set buildx as the default builder

docker buildx install
docker buildx create --use

3. Enable cross-arch emulated builds in docker

docker run --privileged --rm linuxkit/binfmt:v0.8

4. Install yq

sudo snap install yq

5. Install deno

sudo snap install deno

6. Install essentials build packages

sudo apt-get install -y build-essential openssl libssl-dev libc6-dev clang libclang-dev ca-certificates

7. Install Rust

curl https://sh.rustup.rs -sSf | sh
# Choose nr 1 (default install)
source $HOME/.cargo/env

8. Build and install embassy-sdk

cd ~/ && git clone --recursive https://github.com/Start9Labs/embassy-os.git
cd embassy-os/backend/
./install-sdk.sh
embassy-sdk init

Now you are ready to build your hello-world service

Cloning

Clone the project locally.

git clone https://github.com/Start9Labs/hello-world-wrapper.git
cd hello-world-wrapper

Building

To build the Hello World service, run the following command:

make

Installing (on Embassy)

Run the following commands to determine successful install:

ℹ️ Change embassy-q1w2e3r4.local to your Embassy address

embassy-cli auth login
#Enter your embassy password
embassy-cli --host https://embassy-q1w2e3r4.local package install hello-world.s9pk

Tip: You can also install the hello-world.s9pk using Sideload Service under the Embassy > SETTINGS section.

Verify Install

Go to your Embassy Services page, select Hello World, configure and start the service.

Done!