Giter Club home page Giter Club logo

dozzle's Introduction

Dozzle - dozzle.dev

Dozzle is a small lightweight application with a web based interface to monitor Docker logs. It doesn’t store any log files. It is for live monitoring of your container logs only.

dozzle-dark.mp4

Go Report Card Docker Pulls Docker Version Test

Features

  • Intelligent fuzzy search for container names πŸ€–
  • Search logs using regex πŸ”¦
  • Small memory footprint 🏎
  • Split screen for viewing multiple logs
  • Download logs easily
  • Live stats with memory and CPU usage
  • Multi-user authentication with support for proxy forward authorization 🚨

Dozzle has been tested with hundreds of containers. However, it doesn't support offline searching. Products like Loggly, Papertrail or Kibana are more suited for full search capabilities.

Getting Started

Dozzle is a small container (4 MB compressed). Pull the latest release with:

$ docker pull amir20/dozzle:latest

Running Dozzle

The simplest way to use dozzle is to run the docker container. Also, mount the Docker Unix socket with --volume to /var/run/docker.sock:

$ docker run --name dozzle -d --volume=/var/run/docker.sock:/var/run/docker.sock:ro -p 8888:8080 amir20/dozzle:latest

Dozzle will be available at http://localhost:8888/.

Here is the Docker Compose file:

version: "3"
services:
  dozzle:
    container_name: dozzle
    image: amir20/dozzle:latest
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
    ports:
      - 8888:8080

For advanced options like authentication, remote hosts or common questions see documentation at dozzle.dev.

Technical Details

Dozzle users automatic API negotiation which works with most Docker configurations. Dozzle also works with Colima and Podman.

Installation on podman

By default Podman doesn't have a background process but you can enable this for Dozzle to work.

Verify first if your podman installation has enabled remote socket:

podman info

When you get under the key remote socket output like this, its already enabled:

  remoteSocket:
    exists: true
    path: /run/user/1000/podman/podman.sock

If it's not enabled please follow this tutorial to enable it.

Once you have the podman remote socket you can run Dozzle on podman.

podman run --volume=/run/user/1000/podman/podman.sock:/var/run/docker.sock:ro -d -p 8888:8080 amir20/dozzle:latest

Security

Dozzle supports file based authentication and forward proxy like Authelia. These are documented at https://dozzle.dev/guide/authentication.

Analytics collected

Dozzle collects anonymous user configurations using Google Analytics. Why? Dozzle is an open source project with no funding. As a result, there is no time to do user studies of Dozzle. Analytics is collected to prioritize features and fixes based on how people use Dozzle. This data is completely public and can be viewed live using Data Studio dashboard.

If you do not want to be tracked at all, see the --no-analytics flag below.

Environment variables and configuration

Dozzle follows the 12-factor model. Configurations can use the CLI flags or environment variables. The table below outlines all supported options and their respective env vars.

Flag Env Variable Default
--addr DOZZLE_ADDR :8080
--base DOZZLE_BASE /
--hostname DOZZLE_HOSTNAME ""
--level DOZZLE_LEVEL info
--filter DOZZLE_FILTER ""
--username DOZZLE_USERNAME ""
--password DOZZLE_PASSWORD ""
--usernamefile DOZZLE_USERNAME_FILE ""
--passwordfile DOZZLE_PASSWORD_FILE ""
--no-analytics DOZZLE_NO_ANALYTICS false
--remote-host DOZZLE_REMOTE_HOST

Support

There are many ways you can support Dozzle:

  • Use it! Write about it! Star it! If you love Dozzle, drop me a line and tell me what you love.
  • Blog about Dozzle to spread the word. If you are good at writing send PRs to improve the documentation at dozzle.dev
  • Sponsor my work at https://www.buymeacoffee.com/amirraminfar

Buy Me A Coffee

License

MIT

Building

To Build and test locally:

  1. Install NodeJs and pnpm.
  2. Install Go.
  3. Install reflex with go install github.com/cespare/reflex@latest.
  4. Install node modules pnpm install.
  5. Do pnpm dev

dozzle's People

Contributors

amir20 avatar dependabot-preview[bot] avatar dependabot[bot] avatar kodiakhq[bot] avatar renovate[bot] avatar coteh avatar github-actions[bot] avatar dima-bzz avatar akash-ramaswamy avatar amadeusgraves avatar ediflyer avatar ab623 avatar iwittkau avatar codeman1o1 avatar vanodevium avatar peterdavehello avatar feriman22 avatar c-w avatar yldrmali avatar catalinmunteanu avatar zerof avatar tuner88 avatar sureshram avatar rafipiccolo avatar m1ome avatar tuurlijk avatar javad94 avatar jdobosz avatar irwenxyz avatar gex2501 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    πŸ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. πŸ“ŠπŸ“ˆπŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❀️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.