Daemon

Prerequisites

Before you begin the installation process, ensure that your system meets the following requirements:

Operating System: Linux. MacOS works but is unsupported. Windows won't work at all.
gyp installed, this also requires build-essential or other C++ toolchain
pnpm i -g gyp
IP Connection to the Stardust Web server.
A working docker installation - Daemon interface must be exposed via socket or TCP.

Installation

Setup

Install Bun.

curl -fsSL https://bun.sh/install | bash
bun -v

Build

Build the Stardust daemon.

cd apps/daemon
pnpm build

Link

Symlink the built binary to your path.

ln -s $(pwd)/stardustd /usr/local/bin/stardustd

Config file

Create the daemon configuration file.

~/.config/stardustd.yaml

docker:
  network: stardust
  socket: /var/run/docker.sock
session: {}
# yaml-language-server: $schema=/opt/stardust/apps/daemon/schema.json

Configure

Prop	Type	Default
`port`	`number`	`4000`
`host`	`string`	`0.0.0.0`
`service`	`boolean`	`true`
`token`	`string`	-
`docker`	`DockerConfig`	-
`session`	`SessionConfig`	-

Keys

Prop	Type	Default
`type`	`"http" \| "socket"`	`socket`
`socket`	`string`	`/var/run/docker.sock`
`enableIcc`	`boolean`	`false`
`host`	`string`	-
`port`	`number`	-
`protocol`	`"http" \| "https"`	-
`network`	`string`	`stardust`

Start

stardustd

On first start, the app will be automatically daemonized if specified in the config. It will generate and log the token used to authenticate by Stardust Web.

Daemon

Keys

On this page