Skip to content

mimonimo/dockerlens

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

DockerLens

Lightweight Docker Management Dashboard — a beautiful web UI for managing containers, images, volumes, and networks. Like Portainer, but fast, simple, and gorgeous.

Python Docker License FastAPI

Why DockerLens?

Feature DockerLens Portainer Docker CLI
Setup pip install Docker stack Built-in
Weight ~2MB ~200MB+ N/A
Startup Instant 30s+ Instant
Real-time stats Yes Yes docker stats
Log viewer Streaming Yes docker logs -f
Container exec WebSocket terminal Yes docker exec -it
Compose support Yes Yes (paid) CLI only
Dark theme Default Optional N/A

Features

  • Dashboard — Overview of all containers, images, volumes, networks at a glance
  • Container Management — Start, stop, restart, remove, inspect with one click
  • Real-time Stats — Live CPU, memory, network I/O charts per container
  • Log Viewer — Streaming logs with search, filter, and auto-scroll
  • Container Terminal — Full interactive shell via WebSocket (like docker exec -it)
  • Image Management — Pull, remove, inspect images; view layers and tags
  • Volume & Network — Browse and manage Docker volumes and networks
  • Compose — Deploy and manage Docker Compose stacks from the UI
  • Dark Theme — Beautiful dark UI designed for long sessions

Quick Start

pip install dockerlens
dockerlens

Open http://localhost:7420 in your browser. That's it.

Options

dockerlens --port 7420          # Custom port
dockerlens --host 0.0.0.0      # Bind to all interfaces
dockerlens --docker-host unix:///var/run/docker.sock  # Custom Docker socket

Docker

docker run -d \
  -p 7420:7420 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  mimonimo/dockerlens

Screenshots

Container Dashboard

Real-time overview of all running containers with CPU/memory sparklines.

Log Viewer

Stream container logs with syntax highlighting and search.

Container Terminal

Interactive shell directly in the browser — no SSH needed.

Architecture

Browser ──WebSocket──► FastAPI ──Docker SDK──► Docker Engine
          (xterm.js)   (uvicorn)  (docker-py)   (/var/run/docker.sock)
  • Frontend: Vanilla JS + xterm.js (no build step, no node_modules)
  • Backend: FastAPI + Docker SDK for Python
  • Real-time: WebSocket for logs, stats, and exec terminals

Requirements

  • Python 3.10+
  • Docker Engine running locally or accessible via TCP
  • Docker socket accessible (/var/run/docker.sock)

Development

git clone https://github.com/mimonimo/dockerlens.git
cd dockerlens
pip install -e .
dockerlens --reload

License

MIT License. See LICENSE.

About

Lightweight Docker management dashboard — beautiful web UI for containers, images, logs & stats. Like Portainer, but fast and simple.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors