Clams Remote is Remote Control for your Core lightning nodes. This repository creates the .s9pk package that is installed to run clams-remote on StartOS. Learn more about service packaging in the Developer Docs.
Clone this repo locally:
git clone https://github.com/clams-tech/clams-remote-startos
cd clams-remote-startos
git submodule update --init --recursive
Install the system dependencies below to build this project by following the instructions in the provided links. You can find instructions on how to set up the appropriate build environment in the Developer Docs.
Prepare your StartOS build environment. In this example we are using Ubuntu 20.04.
- Install docker
curl -fsSL https://get.docker.com | bash
sudo usermod -aG docker "$USER"
exec sudo su -l $USER
- Set buildx as the default builder
docker buildx install
docker buildx create --use
- Enable cross-arch emulated builds in docker
docker run --privileged --rm linuxkit/binfmt:v0.8
- Install yq
sudo snap install yq
- Install deno
sudo snap install deno
- Install essentials build packages
sudo apt-get install -y build-essential openssl libssl-dev libc6-dev clang libclang-dev ca-certificates
- Install Rust
curl https://sh.rustup.rs -sSf | sh
# Choose nr 1 (default install)
source $HOME/.cargo/env
- Build and install start-sdk
cd ~/ && git clone --recursive https://github.com/Start9Labs/start-os.git --branch sdk
cd start-os/
make sdk
start-sdk init
Now you are ready to build the clams-remote package!
To build the clams-remote package for all platforms using start-sdk, run the following command:
make
To build the clams-remote package for a single platform using start-sdk, run:
# for amd64
make x86
or
# for arm64
make arm
Run the following commands to determine successful install:
start-cli auth login
# Enter your StartOS password
start-cli package install clams-remote.s9pk
If you already have your start-cli config file setup with a default host, you can install simply by running:
make install
Tip: You can also install the clams-remote.s9pk using Sideload Service under the System > Manage section.
Go to your StartOS Services page, select Clams Remote, configure and start the service. Then, verify its interfaces are accessible.
Done!