Enum Step 

pub enum Step {
    WriteFile(GeneratedFile),
    Symlink {
        link: PathBuf,
        target: PathBuf,
    },
    DaemonReload,
    StartService {
        unit: String,
    },
    StopService {
        unit: String,
    },
    RestartService {
        unit: String,
    },
    ReloadCaddy,
    PullImage {
        image: String,
    },
    RemoveFile(PathBuf),
    RemoveDir(PathBuf),
    RemoveVolume {
        name: String,
    },
    CreateDir(PathBuf),
    WaitForFile {
        path: PathBuf,
        timeout_secs: u32,
    },
    CopyFile {
        src: PathBuf,
        dst: PathBuf,
    },
    TailscaleSetup,
    TailscaleEnable {
        svc_name: String,
        host_port: u16,
    },
    TailscaleDisable {
        svc_name: String,
    },
}

A discrete operation that the CLI executes.

Variants

WriteFile(GeneratedFile)

Write a file.

Symlink

Create a symlink at link pointing to target. Idempotent: if link already exists (whether as a file, dir, or symlink), it’s removed first. Used to satisfy systemd’s fixed quadlet path (~/.config/containers/systemd/<svc>.container) while keeping the real file alongside the rest of the service’s data in ~/.local/share/services/<svc>/.

Fields

link: PathBuf

target: PathBuf

DaemonReload

Reload systemd for the current user.

StartService

Start a service under the current user’s systemd.

Fields

unit: String

StopService

Stop a service under the current user’s systemd.

Fields

unit: String

RestartService

Restart a service under the current user’s systemd.

Fields

unit: String

ReloadCaddy

Reload Caddy’s config without restarting the container.

PullImage

Pull a container image.

Fields

image: String

RemoveFile(PathBuf)

Remove a file.

RemoveDir(PathBuf)

Remove a directory tree.

RemoveVolume

Remove a podman named volume.

Fields

name: String

CreateDir(PathBuf)

Create a directory (with parents).

WaitForFile

Wait for a file to appear (with timeout).

Fields

path: PathBuf

timeout_secs: u32

CopyFile

Copy a file from the registry (or similar source) to a destination. Used for vendored binary files (e.g. Jellyfin’s SSO plugin DLLs) that don’t fit the templated configs/ pipeline.

Fields

src: PathBuf

dst: PathBuf

TailscaleSetup

First-time Tailscale Services setup on this tailnet: ensure ACL has tag:ryra-host + tag:ryra-service tagOwners and the services autoApprover entry, then apply tag:ryra-host to the local node so it’s allowed to advertise services. Idempotent: reads current state via API and only writes diffs.

TailscaleEnable

Define a Tailscale Service via the admin API and advertise it from the host: sudo tailscale serve --service=svc:<svc_name> --https=443 http://127.0.0.1:<host_port>. The service gets tag:ryra-service (matches the autoApprover) so the host’s advertisement auto-approves with no manual UI clicks.

svc_name is the part after svc: — already host-scoped at planning time (<service>-<host>) so two ryra hosts on the same tailnet can run independent copies of a service without colliding on the global Tailscale Service namespace.

Fields

svc_name: String

host_port: u16

TailscaleDisable

Stop advertising a Tailscale Service on this host and delete its definition via the admin API. Used in ryra remove --purge and ryra reset for tailscale-enabled services. svc_name matches the value used at install time (recovered from the stored Tailscale URL so a hostname change post-install doesn’t break teardown).

Fields

svc_name: String

Implementations

impl Step

pub fn to_command(&self) -> String

Render this step as a shell command (for dry-run display).