Skip to main content

Services And Recipes

A Fungi service is something named on a device. It may be backed by Docker, Wasmtime, or an existing TCP service.

List Services​

fungi service list

Refresh saved devices before listing:

fungi service list --refresh

Target one saved device:

fungi service list --device my-mac

Plain listing can use the cached service snapshot. --refresh asks saved devices for current service state and updates the snapshot when the device is reachable.

Recipes​

Recipes are official service definitions known to the local daemon.

fungi service recipe list --refresh
fungi service recipe show <recipe-id>

Apply a recipe locally:

fungi service apply files --recipe <recipe-id> --start

Apply it on another saved device:

fungi service apply files@my-mac --recipe <recipe-id> --start

Local Service Files​

Apply a local .fungi.md or YAML service file:

fungi service apply files ./files.fungi.md --start
fungi service apply files@my-mac ./files.fungi.md --start

Preview without changing state:

fungi service apply files ./files.fungi.md --dry-run

Lifecycle​

fungi service start files
fungi service stop files
fungi service inspect files
fungi service logs files
fungi service remove files

Use --device my-mac or files@my-mac where the command supports a remote service target.

Connect​

Create or reuse a local address for a service:

fungi service connect files@my-mac

Pin the local port:

fungi service connect files@my-mac --local-port 18080

Disconnect the local listener while keeping the saved port:

fungi service disconnect files@my-mac

The shortcut uses the same connection flow:

fungi files@my-mac

Startup Restore​

When the daemon starts, it reads saved local preferences and tries to restore local listeners for services you used before. It uses the cached service snapshot as a fallback and refreshes live device state when possible.

If a device is offline, the saved preference is kept. The local listener may still be restored from cache, and the actual connection will succeed later when the device is reachable and the service entry has not changed.