ash service

Run Ash as a background service for persistent operation.

Usage

uv run ash service COMMAND [OPTIONS]

Commands

start

Start Ash as a background service:

uv run ash service start

Options:

Option	Default	Description
--config, -c	auto	Config file path
--webhook	false	Use webhook mode

stop

Stop the running service:

uv run ash service stop

restart

Restart the service:

uv run ash service restart

status

Check service status:

uv run ash service status

Shows:

• Running state
• PID
• Uptime

logs

View service logs:

uv run ash service logs

Options:

Option	Default	Description
--follow, -f	false	Follow log output
--lines, -n	50	Number of lines

install

Install as a system service:

uv run ash service install

Creates a systemd unit file (Linux) or launchd plist (macOS).

uninstall

Remove system service:

uv run ash service uninstall

Examples

Start in background:

uv run ash service start

Check if running:

uv run ash service status

Follow logs:

uv run ash service logs -f

Install for auto-start:

uv run ash service install
sudo systemctl enable ash