Introduction

Docker Hub Overview

The published image is `aimldev/docklog:latest`. It ships DockLog as one self-contained container so you can start quickly without stitching together separate backend and frontend images.

Configuration & Quickstart

DockLog supports two main operational modes: Auth Mode (requires SQLite) and No-Auth Mode (runs database-free).

version: "3.8"
services:
  docklog:
    image: aimldev/docklog:latest
    container_name: docklog
    ports:
      - "8888:8000"
    environment:
      - SECRET_KEY=your-secure-key-here
      - DB_PATH=/app/data/docklog.db
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - ./data:/app/data
    restart: unless-stopped

version: "3.8"
services:
  docklog:
    image: aimldev/docklog:latest
    container_name: docklog
    ports:
      - "8888:8000"
    environment:
      - DISABLE_AUTH=true
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    restart: unless-stopped

version: "3.8"

services:
  docklog:
    image: aimldev/docklog:latest
    container_name: docklog
    ports:
      - "8888:8000"
    environment:
      - SECRET_KEY=generate-secret-here
      - DB_PATH=/app/data/docklog.db
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - ./data:/app/data
    restart: unless-stopped

Reverse Proxy & SSL

DockLog works best behind a reverse proxy when you want HTTPS, a custom domain, or access controls in front of the app.

location / {
  proxy_pass http://127.0.0.1:8888;
  proxy_http_version 1.1;
  proxy_set_header Host $host;
  proxy_set_header X-Real-IP $remote_addr;
  proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  proxy_set_header X-Forwarded-Proto $scheme;
  proxy_set_header Upgrade $http_upgrade;
  proxy_set_header Connection "Upgrade";
}

Security Hardening

Use this checklist when DockLog moves from a private lab install to a team-facing environment.

Forgotten Password Recovery

If an administrator forgets their login credentials, they can reset their password directly on the SQLite database using Docker commands. Since DockLog does not store credentials in external clouds, you must edit the local file.

Step-by-step Reset Guide

1. Locate the Container ID:

   Find your active DockLog container's running ID:

   bashCopy

   docker ps | grep docklog

2. Open Container SQLite CLI:

   Execute the SQLite interactive command shell directly inside your running container (replacing docklog with your container name/ID, and pointing to the mapped DB file, e.g. /app/data/docklog.db):

   bashCopy

   docker exec -it docklog sqlite3 /app/data/docklog.db

3. Check Users Table:

   Search your users table to find the target username. The default administrator is named admin:

   sqlCopy

   SELECT id, username, password_changed FROM users;

4. Update User Password:

   You can update the password column using one of the following two options:

   Option A: Reset to the default password (admin123)

   Run this SQL update statement containing the pre-calculated bcrypt hash for the default password:

   sqlCopy

   UPDATE users SET password = '$2a$10$2.6QG/Jm7bJb6oU7Y7CReeA16.0OqS12c2.B3X9kS03Vz1.Vz21Yy', password_changed = 0 WHERE username = 'admin';

   Option B: Generate and set a custom password

   If you prefer to configure a custom password, generate its bcrypt hash on your host terminal (e.g. using Python):

   bashCopy

   python3 -c "import bcrypt; print(bcrypt.hashpw(b'your_custom_password', bcrypt.gensalt()).decode('utf-8'))"

   Then, use your generated hash inside the SQL update statement:

   sqlCopy

   UPDATE users SET password = 'YOUR_GENERATED_HASH_HERE', password_changed = 0 WHERE username = 'admin';

5. Exit SQLite:

   Close the database tool:

   sqlCopy

   .exit

Troubleshooting

These are the most common issues teams run into during first deploys and proxy-based setups.

Backup & Upgrade

DockLog keeps important state in the mapped data directory when auth mode is enabled. Back up that folder before upgrading or migrating hosts.

docker pull aimldev/docklog:latest
docker compose up -d --force-recreate

RBAC Rules & Regex Permissions

Architecture Overview

DockLog is designed as a compact, self-hosted pipeline that reads directly from Docker, renders in the browser, and keeps storage local when auth mode is enabled.

Product Tour

DockLog provides a unified workspace for managing Docker infrastructure, monitoring container activity, streaming logs, and controlling team access. Everything is designed to help operators spend less time switching tools and more time maintaining reliable systems.

Future Roadmap

DockLog is evolving beyond a simple log viewer into a comprehensive container operations platform. Our roadmap focuses on improving observability, automation, scalability, and developer productivity while maintaining the lightweight experience that makes DockLog easy to deploy and manage.