Struct Daemon 

pub struct Daemon {

    pub id: DaemonId,
    pub title: Option<String>,
    pub pid: Option<u32>,
    pub start_time: Option<u64>,
    pub boot_time: Option<u64>,
    pub shell_pid: Option<u32>,
    pub status: DaemonStatus,
    pub dir: Option<PathBuf>,
    pub cmd: Option<Vec<String>>,
    pub run: Option<String>,
    pub autostop: bool,
    pub cron_schedule: Option<String>,
    pub cron_retrigger: Option<CronRetrigger>,
    pub cron_immediate: Option<bool>,
    pub last_cron_triggered: Option<DateTime<Local>>,
    pub last_exit_success: Option<bool>,
    pub retry: Retry,
    pub retry_count: u32,
    pub ready_delay: Option<u64>,
    pub ready_output: Option<ReadyOutput>,
    pub ready_http: Option<ReadyHttp>,
    pub ready_port: Option<ReadyPort>,
    pub ready_cmd: Option<ReadyCmd>,
    pub health_cmd: Option<HealthCmd>,
    pub health_http: Option<HealthHttp>,
    pub health_port: Option<HealthPort>,
    pub port: Option<PortConfig>,
    pub resolved_port: Vec<u16>,
    pub active_port: Option<u16>,
    pub slug: Option<String>,
    pub proxy: Option<bool>,
    pub depends: Vec<DaemonId>,
    pub env: Option<IndexMap<String, String>>,
    pub watch: Vec<String>,
    pub watch_mode: WatchMode,
    pub watch_base_dir: Option<PathBuf>,
    pub mise: Option<bool>,
    pub user: Option<String>,
    pub memory_limit: Option<MemoryLimit>,
    pub cpu_limit: Option<CpuLimit>,
    pub stop_signal: Option<StopConfig>,
    pub archive_hook: Option<String>,
    pub log_format: Option<String>,
    pub pty: Option<bool>,
    pub config_registered: bool,
    pub oneshot: bool,
    pub proxy_idle_timeout_ms: Option<u64>,
    pub last_cron_run: Option<DateTime<Local>>,
    pub no_shell: bool,
    pub scheduled_from_config: bool,
}

Fields

id: DaemonId

title: Option<String>

pid: Option<u32>

start_time: Option<u64>

High-resolution kernel start token recorded at spawn. Together with pid this identifies the process across a supervisor crash: a recycled PID has a different token, so orphan cleanup can tell a genuine orphan from an unrelated process.

boot_time: Option<u64>

System boot time (seconds since epoch) recorded at spawn. Lets orphan reconciliation tell a daemon that died under a crashed supervisor during this boot from one whose process died with the machine, which need different terminal states. Unlike start_time this is a wall-clock value comparable across processes and platforms.

shell_pid: Option<u32>

status: DaemonStatus

dir: Option<PathBuf>

cmd: Option<Vec<String>>

run: Option<String>

Original shell command string, persisted for retry/watch restarts.

autostop: bool

cron_schedule: Option<String>

cron_retrigger: Option<CronRetrigger>

cron_immediate: Option<bool>

last_cron_triggered: Option<DateTime<Local>>

last_exit_success: Option<bool>

retry: Retry

retry_count: u32

ready_delay: Option<u64>

ready_output: Option<ReadyOutput>

ready_http: Option<ReadyHttp>

ready_port: Option<ReadyPort>

ready_cmd: Option<ReadyCmd>

health_cmd: Option<HealthCmd>

health_http: Option<HealthHttp>

health_port: Option<HealthPort>

port: Option<PortConfig>

Port configuration (expected ports and auto-bump settings)

resolved_port: Vec<u16>

Resolved ports actually used after auto-bump (may differ from expected)

active_port: Option<u16>

The first port the process is actually listening on (detected at runtime via listeners crate). This is the source of truth for the reverse proxy. Cleared when the daemon stops.

slug: Option<String>

Optional stable slug alias for this daemon (used in proxy URLs and CLI commands).

proxy: Option<bool>

Whether to proxy this daemon (None = inherit global proxy.enable setting).

depends: Vec<DaemonId>

env: Option<IndexMap<String, String>>

watch: Vec<String>

watch_mode: WatchMode

watch_base_dir: Option<PathBuf>

mise: Option<bool>

Whether to use mise for this daemon (None = inherit global general.mise setting).

Schema compatibility note

This field changed from bool to Option<bool> with skip_serializing_if = "Option::is_none".

• Upgrade (old → new): safe — old files contain mise = true/false, which deserialize correctly as Some(true) / Some(false).
• Downgrade (new → old): if mise is None (inherit global), the key is omitted from the state file. An old binary reads the missing key as false, ignoring general.mise = true. Any daemon that relied on the global setting would silently stop using mise after a downgrade.

user: Option<String>

Unix user to run this daemon as.

memory_limit: Option<MemoryLimit>

Memory limit for the daemon process (e.g. “50MB”, “1GiB”)

cpu_limit: Option<CpuLimit>

CPU usage limit as a percentage (e.g. 80 for 80%, 200 for 2 cores)

stop_signal: Option<StopConfig>

Unix signal to send for graceful shutdown (default: SIGTERM)

archive_hook: Option<String>

Archive hook command invoked before retention prunes this daemon’s logs.

log_format: Option<String>

Log format for this daemon.

pty: Option<bool>

Allocate a pseudo-terminal for the daemon process.

config_registered: bool

True for daemons auto-registered from config by the cron watcher, not yet started. Treated as “available” by list/status/stats.

oneshot: bool

Run-to-completion task rather than a long-running service. Readiness is a zero exit code, and the terminal state is completed instead of stopped. See DaemonStatus::Completed.

Appended rather than grouped with status: IPC encodes this struct positionally, so a field inserted in the middle shifts every field after it for a peer that does not have it.

proxy_idle_timeout_ms: Option<u64>

Set when the proxy started this run and it may be stopped for inactivity: how long, in milliseconds, it may go without proxy activity. None for a daemon started any other way, or claimed since by an explicit start.

Appended last for the positional IPC encoding, like oneshot.

last_cron_run: Option<DateTime<Local>>

When the cron watcher last actually started this daemon.

Distinct from last_cron_triggered, which advances on every scheduled tick the watcher observes – including the anchoring tick that immediate = false uses to skip the first window, and ticks where the retrigger policy declines to run. Only this field means “it ran”, which is what last_exit_success describes the outcome of.

Appended after proxy_idle_timeout_ms for the positional IPC encoding.

no_shell: bool

Start cmd directly, without a shell. See RunOptions::no_shell.

Appended after last_cron_run for the positional IPC encoding.

scheduled_from_config: bool

Registered from config by the cron watcher and only ever started by its schedule since, so each scheduled run is built from the current config, templates rendered, rather than from what was stored at registration. Cleared once a client starts the daemon: a run it asked for carries its own options, which the schedule then keeps.

Appended after no_shell for the positional IPC encoding.

Implementations

impl Daemon

pub fn next_cron_run(&self, now: DateTime<Local>) -> Option<DateTime<Local>>

The next time the cron watcher will consider this daemon due, or None when it has no schedule or the schedule does not parse.

Anchored exactly the way check_cron_schedules anchors itself, so the answer is what the watcher will actually do rather than an independent reading of the schedule. That includes the case where the supervisor was down across a window: the anchor is still the old tick, so the result is a time in the past – the overdue run the watcher takes on its next check.

pub fn to_run_options(&self, cmd: Vec<String>) -> RunOptions

Build RunOptions from persisted daemon state.

Carries over all configuration fields from the daemon state. Callers can override specific fields on the returned value.

Trait Implementations

impl Clone for Daemon

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Daemon

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Daemon

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Daemon

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Daemon

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Serialize for Daemon

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.