kosa8 docs

Commands / kosa8 daemon start

kosa8 daemon start

Start kosa8d in the background

Starts the daemon. With --listen it serves the API over TCP behind a generated token (~/.kosa8/worker-token) so other devices can drive this machine — pair them with kosa8 worker pair — and this CLI keeps working, over loopback. The unix socket is served as well, unchanged, for this machine's Docker clients and SDKs.

Docker clients may bind-mount host paths (docker run -v) only below a directory named with --allow-mount DIR (read-only) or DIR:rw. The list replaces the saved one (~/.kosa8/allow-mounts.json) and is what the engine VM can see of the host; nothing else is shared. kosa8's own state directory and API sockets never are.

Options

FlagTypeWhat it doesDefault
--allow-mountstringArrayhost directory Docker clients may bind-mount from, DIR (read-only) or DIR:rw (repeatable; replaces the saved list)[]
--listenstringserve the API on this TCP address (e.g. 127.0.0.1:7440) for other devices—
--no-allow-mountsboolclear the saved list: Docker clients may bind-mount nothing—