https://github.com/mishankov/web-tail

📖 Web based log monitoring tool
https://github.com/mishankov/web-tail

docker golang log logging monitoring real-time ssh svelte

Last synced: 4 months ago
JSON representation

📖 Web based log monitoring tool

• Host: GitHub
• URL: https://github.com/mishankov/web-tail
• Owner: mishankov
• License: mit
• Created: 2022-01-24T14:23:19.000Z (over 4 years ago)
• Default Branch: main
• Last Pushed: 2026-02-01T23:13:13.000Z (5 months ago)
• Last Synced: 2026-02-02T08:55:43.963Z (5 months ago)
• Topics: docker, golang, log, logging, monitoring, real-time, ssh, svelte
• Language: Go
• Homepage:
• Size: 640 KB
• Stars: 19
• Watchers: 1
• Forks: 4
• Open Issues: 11
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Web tail

[![CI](https://github.com/mishankov/web-tail/actions/workflows/ci.yml/badge.svg)](https://github.com/mishankov/web-tail/actions/workflows/ci.yml)

[![CodeFactor](https://www.codefactor.io/repository/github/mishankov/web-tail/badge)](https://www.codefactor.io/repository/github/mishankov/web-tail)

Web application to view lines from file on local system or on remote server built with [Svelte](https://github.com/sveltejs/svelte)

![](images/image-1.png)

## Installation

Download and unpack `web-tail-[platform].zip` from [latest release](https://github.com/mishankov/web-tail/releases/latest)

Docker image is also available [here](https://github.com/mishankov/web-tail/pkgs/container/web-tail)

## Configuration

In unpacked folder edit `web-tail.config.toml` file

- `port` - port that Web tail will run on. Defaults value is `4444`

- `allowedOrigins` - list of allowed origins for WebSocket connections. Defaults value is ["*"] which allows all origins

- `servers` - reusable servers configuration

  - `name` - name of server to use in `sources` configs

  - `host` - host of remote server. Mandatory field for source types `ssh:*`

  - `port` - port of remote server. Mandatory field for source types `ssh:*`

  - `username` - username for ssh connection to remote server. Mandatory for source types `ssh:*`

  - `password` - password to authenticate on remote server. Either this or `privateKeyPath` is mandatory for source types `ssh:*`

  - `privateKeyPath` - path to file with private key to authenticate on remote server. Either this or `password` is mandatory for source types `ssh:*`

- `sources` - list of sources to tail lines from

  - `name` - name of source. Mandatory field

  - `type` - type of source. Possible values: `local:file`, `local:docker`, `local:openclaw`, `ssh:file`, `ssh:docker`, `ssh:openclaw`. Mandatory field

  - `path` - path to file. Mandatory field for source types `*:file`

  - `serverName` - name of a server from `servers` list

  - `containerId` - Docker container ID. Mandatory field for source types `*:docker`

  - `host` - host of remote server. Mandatory field for source types `ssh:*`

  - `port` - port of remote server. Mandatory field for source types `ssh:*`

  - `username` - username for ssh connection to remote server. Mandatory for source types `ssh:*`

  - `password` - password to authenticate on remote server. Either this or `privateKeyPath` is mandatory for source types `ssh:*`

  - `privateKeyPath` - path to file with private key to authenticate on remote server. Either this or `password` is mandatory for source types `ssh:*`

## Usage

![](images/image-2.png)

Options from left to right:

- Dropdown to select one of sources from `web-tail.config.toml`

- Search field. Matching results will be selected. Search is case insensitive by default

- `Filter` toggle. If enabled only lines with matching results are shown

- `.*` toggle. If enabled treats text in search field as regular expression

- `Aa` toggle. If enabled makes search case sensitive

- `Reverse` toggle. If enabled latest lines shown on top

- Max lines field. How much lines will be shown

## Development

Set environment variable `ASSETS=dist/public` before doing `go run ./server` to use preemtively compiled assets