setup

Write config, or wipe Queue state on this host.

julia -m DistSSHKitQueue setup [--force]
julia -m DistSSHKitQueue teardown -y

Also: Prepare, waiter, hosts. setup refuses qhost:. teardown can run from a client (qhost:HOST teardown -y).

setup is optional. Defaults work without config.toml. Re-run is a no-op unless --force.

Flags

Flag	Meaning
`--force`	`setup`: rewrite `config.toml`
`--config PATH`	`setup` / `teardown`: config path (`DISTSSHKITQUEUE_CONFIG`)
`-y` / `--yes`	`teardown`: confirm (`DISTSSHKIT_YES`; same values as DistSSHKit)
`--write-only`	`teardown`: do not stop the waiter or unload the OS unit
`--home DIR`	`teardown`: home for `~/.distsshkitqueue`
`--bindir DIR`	`teardown`: leftover `dskq` shim path
`-h` / `--help`	Queue usage

DISTSSHKITQUEUE_YES is gone. [env] in the target config.toml still applies.

Stops the waiter, removes the OS unit and ~/.distsshkitqueue. Does not Pkg.rm, and never deletes a git clone or Kit .distsshkit/ results. Trees: Where files live. Still removes a leftover ~/.local/bin/dskq if present.

config.toml

~/.distsshkitqueue/config.toml. Override: DISTSSHKITQUEUE_CONFIG. Resolution: CLI / ENV > config.toml > built-in defaults. [env] keys use get! so a real ENV value wins.

store = "~/.distsshkitqueue/jobs.toml"
# hosts = ["parent", "child:host1:4"]

[env]
# DISTRIBUTED_SSH_OPTS = "-F /path/to/ssh_config"
# DISTSSHKIT_YES = "1"
# Do not set DISTRIBUTED_REMOTE_PROJECT_ROOT here on a shared queue host.

Key	Meaning
`store`	Job table path (`DISTSSHKITQUEUE_STORE`)
`hosts`	Kit tokens; missing = allow-all; `[]` = allow none
`[env]`	Default ENV for this host (not `DISTSSHKITQUEUE_HOST`). Skip `DISTRIBUTED_REMOTE_PROJECT_ROOT` unless this box is one job

CLI submit re-reads hosts each time (submit). Library submit! uses Queue(; allowed=…) unless follow_config=true.