{"id":13416074,"url":"https://github.com/amir20/dozzle","last_synced_at":"2026-04-17T02:01:47.205Z","repository":{"id":37359441,"uuid":"155297903","full_name":"amir20/dozzle","owner":"amir20","description":"Realtime log viewer for containers.  Supports Docker, Swarm and K8s. ","archived":false,"fork":false,"pushed_at":"2025-05-05T15:49:18.000Z","size":151047,"stargazers_count":8367,"open_issues_count":4,"forks_count":367,"subscribers_count":41,"default_branch":"master","last_synced_at":"2025-05-05T17:21:05.769Z","etag":null,"topics":["docker","docker-container","golang","k8s","log","logging","logging-server","real-time","sever-events","swarm","vuejs"],"latest_commit_sha":null,"homepage":"https://dozzle.dev/","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/amir20.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/funding.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":"docs/support.md","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"buy_me_a_coffee":"amirraminfar"}},"created_at":"2018-10-30T00:05:23.000Z","updated_at":"2025-05-05T15:49:22.000Z","dependencies_parsed_at":"2024-01-17T23:55:21.711Z","dependency_job_id":"3d4aa984-ac85-4e51-b270-2d9d93e5906e","html_url":"https://github.com/amir20/dozzle","commit_stats":{"total_commits":2782,"total_committers":25,"mean_commits":111.28,"dds":0.5334291876347952,"last_synced_commit":"685b17ef4e2f72a36978735439b58d6d93c0e734"},"previous_names":[],"tags_count":488,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amir20%2Fdozzle","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amir20%2Fdozzle/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amir20%2Fdozzle/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amir20%2Fdozzle/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/amir20","download_url":"https://codeload.github.com/amir20/dozzle/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253122618,"owners_count":21857540,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docker","docker-container","golang","k8s","log","logging","logging-server","real-time","sever-events","swarm","vuejs"],"created_at":"2024-07-30T21:00:54.066Z","updated_at":"2026-04-17T02:01:47.199Z","avatar_url":"https://github.com/amir20.png","language":"Go","readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/logo.svg\" alt=\"Dozzle Logo\" width=\"200\"/\u003e\n\u003c/p\u003e\n\n# Dozzle - [dozzle.dev](https://dozzle.dev/)\n\nDozzle is a lightweight, web-based application for monitoring Docker logs in real time. It doesn't store any log files—it's designed purely for live log viewing.\n\nhttps://github.com/user-attachments/assets/66a7b4b2-d6c9-4fca-ab04-aef6cd7c0c31\n\n[![Docker Image Size (latest by date)](https://img.shields.io/docker/image-size/amir20/dozzle)](https://hub.docker.com/r/amir20/dozzle/)\n[![Docker Pulls](https://img.shields.io/docker/pulls/amir20/dozzle.svg)](https://hub.docker.com/r/amir20/dozzle/)\n[![Docker Version](https://img.shields.io/docker/v/amir20/dozzle?sort=semver)](https://hub.docker.com/r/amir20/dozzle/)\n![Test](https://github.com/amir20/dozzle/workflows/Test/badge.svg)\n\n\u003e [!NOTE]\n\u003e If you like Dozzle, check out [`dtop`](https://github.com/amir20/dtop), a top-like application for monitoring Docker containers. It integrates with Dozzle to link directly to container logs.\n\n## Features\n\n- Intelligent fuzzy search for container names\n- Search logs using regex\n- Search logs using [SQL queries](https://dozzle.dev/guide/sql-engine)\n- Small memory footprint\n- Split screen for viewing multiple logs\n- Live stats with memory and CPU usage\n- Multi-user [authentication](https://dozzle.dev/guide/authentication) with support for forward proxy authorization\n- [Swarm mode](https://dozzle.dev/guide/swarm-mode) support\n- [Agent mode](https://dozzle.dev/guide/agent) for monitoring multiple Docker hosts\n- Dark mode\n\nDozzle has been tested with hundreds of containers. However, it doesn't support offline searching. Products like [Loggly](https://www.loggly.com), [Papertrail](https://papertrailapp.com), or [Kibana](https://www.elastic.co/products/kibana) are better suited for full search capabilities.\n\n## Getting Started\n\nDozzle is a small container (7 MB compressed). Pull the latest release with:\n\n    $ docker pull amir20/dozzle:latest\n\n### Running Dozzle\n\nThe simplest way to use Dozzle is to run the Docker container. Mount the Docker Unix socket with `--volume` to `/var/run/docker.sock`:\n\n    $ docker run --name dozzle -d --volume=/var/run/docker.sock:/var/run/docker.sock -p 8080:8080 amir20/dozzle:latest\n\nDozzle will be available at [http://localhost:8080/](http://localhost:8080/).\n\nHere is a Docker Compose example:\n\n    services:\n      dozzle:\n        container_name: dozzle\n        image: amir20/dozzle:latest\n        volumes:\n          - /var/run/docker.sock:/var/run/docker.sock\n        ports:\n          - 8080:8080\n\nFor advanced options like [authentication](https://dozzle.dev/guide/authentication), [remote hosts](https://dozzle.dev/guide/remote-hosts), or common [questions](https://dozzle.dev/guide/faq), see the documentation at [dozzle.dev](https://dozzle.dev/guide/getting-started).\n\n## Swarm Mode\n\nDozzle works with Docker Swarm. You can run Dozzle as a global service:\n\n    $ docker service create --name dozzle --env DOZZLE_MODE=swarm --mode global --mount type=bind,source=/var/run/docker.sock,target=/var/run/docker.sock -p 8080:8080 amir20/dozzle:latest\n\nSee the [Swarm Mode](https://dozzle.dev/guide/swarm-mode) documentation for more details.\n\n## Agent Mode\n\nDozzle can monitor multiple Docker hosts. Run Dozzle in agent mode with:\n\n    $ docker run -v /var/run/docker.sock:/var/run/docker.sock -p 7007:7007 amir20/dozzle:latest agent\n\nSee the [Agent Mode](https://dozzle.dev/guide/agent) documentation for more details.\n\n## Technical Details\n\nDozzle uses automatic API negotiation, which works with most Docker configurations. Dozzle also works with [Colima](https://github.com/abiosoft/colima) and [Podman](https://podman.io/).\n\n### Installation on Podman\n\nBy default, Podman doesn't have a background process, but you can enable the remote socket for Dozzle to work.\n\nFirst, verify if your Podman installation has the remote socket enabled:\n\n```\npodman info\n```\n\nIf you see output like this under the remote socket key, it's already enabled:\n\n```\n  remoteSocket:\n    exists: true\n    path: /run/user/1000/podman/podman.sock\n```\n\nIf it's not enabled, follow [this tutorial](https://github.com/containers/podman/blob/main/docs/tutorials/socket_activation.md) to enable it.\n\nOnce the Podman remote socket is enabled, you can run Dozzle:\n\n```\npodman run --volume=/run/user/1000/podman/podman.sock:/var/run/docker.sock -d -p 8080:8080 docker.io/amir20/dozzle:latest\n```\n\nAdditionally, you need to create a fake engine-id to prevent `host not found` errors. Podman doesn't generate an engine-id like Docker does, due to its daemonless architecture.\n\nCreate a file named `engine-id` under `/var/lib/docker`. On a system with Podman, you'll need to create the folder path as well. Place a UUID inside the file, for example using `uuidgen \u003e engine-id`. The file should contain an identifier like: `b9f1d7fc-b459-4b6e-9f7a-e3d1cd2e14a9`.\n\nFor more details, see [Podman Info](docs/guide/podman.md) or the [FAQ](docs/guide/faq.md#i-am-seeing-host-not-found-error-in-the-logs-how-do-i-fix-it).\n\n## Security\n\nDozzle supports file-based authentication and forward proxy authentication with tools like [Authelia](https://www.authelia.com/). See the documentation at https://dozzle.dev/guide/authentication.\n\n## Analytics\n\nDozzle collects anonymous user configurations using Google Analytics. Why? Dozzle is an open source project with no funding, so there's no time for formal user studies. Analytics help prioritize features and fixes based on how people use Dozzle. This data is completely public and can be viewed live on the [Data Studio dashboard](https://datastudio.google.com/s/naeIu0MiWsY).\n\nTo disable analytics, use the `--no-analytics` flag.\n\n## Environment Variables and Configuration\n\nDozzle follows the [12-factor](https://12factor.net/) model. Configuration can be done via CLI flags or environment variables. See the documentation at [dozzle.dev/guide/supported-env-vars](https://dozzle.dev/guide/supported-env-vars) for more details.\n\n## Support\n\nThere are many ways to support Dozzle:\n\n- Use it! Write about it! Star it! If you love Dozzle, drop me a line and tell me what you love.\n- Blog about Dozzle to spread the word. If you're good at writing, send PRs to improve the documentation at [dozzle.dev](https://dozzle.dev/).\n- Sponsor my work at https://www.buymeacoffee.com/amirraminfar\n\n\u003ca href=\"https://www.buymeacoffee.com/amirraminfar\" target=\"_blank\"\u003e\u003cimg src=\"https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png\" alt=\"Buy Me A Coffee\" style=\"height: 60px !important;width: 217px !important;\" \u003e\u003c/a\u003e\n\n## License\n\n[MIT](LICENSE)\n\n## Building\n\nTo build and test locally:\n\n1. Install [Node.js](https://nodejs.org/en/download/) and [pnpm](https://pnpm.io/installation).\n2. Install [Go](https://go.dev/doc/install).\n3. Install [protoc](https://grpc.io/docs/protoc-installation/).\n4. Install Go tools with `go install tool`.\n5. Install Node modules with `pnpm install`.\n6. Run `make dev` to start a development server with hot reload.\n","funding_links":["https://buymeacoffee.com/amirraminfar","https://www.buymeacoffee.com/amirraminfar"],"categories":["Container Operations","Go","Vue","Apps","置顶","语音识别与合成_其他","Docker-UI","golang","Monitoring","vuejs","容器管理与运维 (Container Operations)"],"sub_categories":["Monitoring","Container","05、运维监控体系","资源传输下载","监控与日志 (Monitoring \u0026 Logging)"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famir20%2Fdozzle","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Famir20%2Fdozzle","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famir20%2Fdozzle/lists"}