logs
View process logs.
Usage
runix logs [id|name] [flags]
Description
Without arguments, shows combined logs from all applications sorted by timestamp. With an app name or ID, shows logs for that specific process.
Examples
# Last 50 lines for a process
runix logs api
# Last 100 lines
runix logs api --lines 100
# Stream live output (follow mode)
runix logs api --follow
# Show stderr instead of stdout
runix logs api --stderr
# Show only error lines
runix logs api --error
# Combined logs from all apps
runix logs
# Combined logs with follow
runix logs --follow
# Combined error lines only
runix logs --error
Flags
| Flag | Short | Default | Description |
|---|---|---|---|
--follow | -f | false | Stream log output in real time |
--lines | -n | 50 | Number of lines to show |
--stderr | false | Show stderr instead of stdout | |
--error | false | Show only lines containing [err] |
Combined Logs
When called without a target, runix logs shows combined logs from all applications:
api | 2025-01-15 10:30:00 [out] Server started
worker | 2025-01-15 10:30:01 [out] Processing job #1
api | 2025-01-15 10:30:05 [err] Connection timeout
worker | 2025-01-15 10:30:06 [out] Job #1 completed
Lines are sorted by timestamp across all processes.
Log File Location
~/.runix/apps/<name>/stdout.log
~/.runix/apps/<name>/stderr.log
Log Format
Each log line is prefixed with a timestamp and source marker:
2025-01-15 10:30:00 [out] Server listening on :8080
2025-01-15 10:30:01 [err] Connection refused
Follow Mode
In follow mode, Runix polls the log file(s) every 200ms for new content. Combined follow mode polls all app log files in rotation.
What's Next
- Log Management — Log storage, rotation, and file structure
- Flush Command — Clear log files