Logs

Navigate to System > Logs to stream real-time output from any Koios service or browse archived log files. The page has two tabs — Live Logs and Log Files.

Live Logs

The Live Logs tab streams log output from a selected service in real time using server-sent events (SSE).

Selecting a Service

The left panel lists all available services. Each entry shows the service name, a brief description, and a badge indicating its current log level. Click a service to begin streaming its logs in the terminal on the right.

Use the search bar at the top of the list to filter services by name or description.

Log Terminal

Once a service is selected, its log output streams into a terminal-style viewer.

Control	Description
Log level	Dropdown to change the service's verbosity (Debug, Info, Warning, Error, Critical). Takes effect immediately.
Search	Text filter that hides lines not matching your query. The footer shows how many lines match (e.g., "50 of 200 lines").
Auto-scroll	The terminal follows new output automatically. Scroll up to pause auto-scroll; scroll back to the bottom to resume. A floating jump-to-bottom button appears when scrolled up.
Pause / Resume	Pauses incoming lines without disconnecting. Buffered lines are shown in the footer and flush to the terminal when you resume.
Clear	Removes all lines from the terminal.

Log Level Colors

Lines are color-coded by severity:

Level	Color
Critical	Red (bold)
Error	Red
Warning	Yellow
Info	Cyan
Debug	Gray

Connection Status

A badge in the terminal footer shows the current streaming state — Connecting, Connected, Error, or Disconnected. The connection automatically attempts to reconnect on error.

Adjust log level for troubleshooting

Set a service to Debug for maximum detail when investigating an issue, then return it to Info or Warning afterward to reduce noise. The change applies immediately — no service restart required.

Log Files

The Log Files tab lets you browse, search, and download archived log files stored on the server.

File List

The left panel lists all log files with their filename, associated service, file size, and last-modified date. Click a file to open it in the viewer on the right.

Each file has a context menu (three-dot icon) with options to View, Download, or Delete the file. Deleting a log file is permanent and requires confirmation.

Use the search bar to filter files by name or service.

File Viewer

The file viewer displays the selected log file with line numbers, color-coded by log level (same colors as the live terminal).

Control	Description
Search	Text search within the file. Filters to lines containing your query and resets to page 1.
Level filter	Dropdown to show only lines at a specific severity (Debug, Info, Warning, Error, Critical) or all levels.
Pagination	Files are displayed 500 lines per page. Use the Previous / Next buttons to navigate. The footer shows the current page, total pages, and total line count.
Refresh	Re-fetches the current page to pick up newly written lines.
Download	Downloads the full log file to your computer.

Server-side filtering

Search and level filters are applied on the server, so only matching lines count toward pagination. This makes it efficient to find specific entries in large log files.

Settings

The Settings tab provides configuration options for log-related behavior:

Debug Timer — configure how long debug-level logging stays active before automatically reverting to the previous log level. This prevents accidentally leaving services in verbose debug mode.
Log File Retention — set how long archived log files are kept before automatic cleanup. Older files are removed to manage disk usage.
Active Debug Services — lists all services currently running with debug-level logging enabled, along with how much time remains before each reverts.

What's Next

Services — view service status, restart services, and check diagnostics
System Health — monitor CPU, memory, network, and disk usage

Network