Sign inSign up

rizkybs70/syslog-flow

By rizkybs70

Updated 2 days ago

syslog collector with Web UI, persistent raw log storage, and optional Basic Auth

Image
Networking
Web servers
Monitoring & observability
0

77

rizkybs70/syslog-flow repository overview

syslog-flow Multi-Arch

Unofficial multi-architecture Docker image based on syslog-flow.

This build adds optional HTTP Basic Authentication for the Web UI using environment variables, while keeping the original lightweight syslog collection and raw log storage design.

Supported platforms:

  • linux/amd64
  • linux/arm64

Docker automatically pulls the correct architecture for the host.


Features

  • Syslog collection over UDP and TCP
  • Lightweight Web UI
  • Raw log storage
  • Search and filtering
  • Persistent log storage
  • Optional HTTP Basic Auth
  • AMD64 and ARM64 support
  • Single multi-arch latest image

Quick Start

docker run -d \
  --name syslog-flow \
  --restart unless-stopped \
  -p 5514:514/udp \
  -p 5514:514/tcp \
  -p 8081:2200/tcp \
  -e TZ=Asia/Jakarta \
  -e SYSLOG_FLOW_AUTH_ENABLED=true \
  -e SYSLOG_FLOW_USERNAME=admin \
  -e SYSLOG_FLOW_PASSWORD='ChangeThisPassword' \
  -v /opt/syslog-flow/logs:/logs \
  -v /opt/syslog-flow/config:/config \
  -v /etc/localtime:/etc/localtime:ro \
  rizkybs70/syslog-flow:latest

Open the Web UI:

http://SERVER-IP:8081

Ports

PortProtocolUsage
514UDPSyslog UDP listener
514TCPSyslog TCP listener
2200TCPWeb UI

The example above maps them to:

5514/udp -> 514/udp
5514/tcp -> 514/tcp
8081/tcp -> 2200/tcp

Authentication

This build adds optional HTTP Basic Authentication for the Web UI.

Enable authentication:

SYSLOG_FLOW_AUTH_ENABLED=true

Set credentials:

SYSLOG_FLOW_USERNAME=admin
SYSLOG_FLOW_PASSWORD=ChangeThisPassword

To disable authentication:

SYSLOG_FLOW_AUTH_ENABLED=false

When authentication is enabled, the Web UI and HTTP API require valid credentials.

Syslog ingestion over UDP and TCP is not affected.

Basic Auth should be used behind HTTPS when the Web UI is exposed outside a trusted LAN or VPN.


Persistent Storage

Logs:

/logs

Configuration:

/config

Recommended mounts:

-v /opt/syslog-flow/logs:/logs \
-v /opt/syslog-flow/config:/config

Example Architecture

Router / Switch / Server
          |
          | Syslog UDP/TCP
          v
    +-------------+
    | syslog-flow |
    |             |
    |   rsyslog   |
    |      |      |
    |   Raw Logs  |
    |      |      |
    |    Web UI   |
    +-------------+
          |
          v
       Browser

Pull Image

docker pull rizkybs70/syslog-flow:latest

Supported architectures:

linux/amd64
linux/arm64

Upstream

Original project:

https://github.com/inventor7777/syslog-flow

All credits for the original application belong to the upstream developer and contributors.

This repository provides an unofficial multi-architecture Docker build with an additional optional Basic Auth layer for the Web UI.


Disclaimer

This is an unofficial community build and is not affiliated with or officially endorsed by the upstream syslog-flow project.

Tag summary

Content type

Image

Digest

sha256:5eb15da84

Size

36.6 MB

Last updated

2 days ago

docker pull rizkybs70/syslog-flow