Add Docker support with bundled ClickHouse server

Author: alex-clickhouse

.dockerignore

@@ -0,0 +1,5 @@
+node_modules
+dist
+.git
+*.md
+.static

Dockerfile

@@ -0,0 +1,31 @@
+# Build stage
+FROM node:20-alpine AS builder
+WORKDIR /app
+COPY package*.json ./
+RUN npm ci
+COPY . .
+RUN npm run build
+
+# Runtime stage
+FROM clickhouse/clickhouse-server:latest
+
+# Install nginx and supervisor
+RUN apt-get update && apt-get install -y nginx supervisor && rm -rf /var/lib/apt/lists/*
+
+# Copy built frontend
+COPY --from=builder /app/dist /var/www/html
+
+# Copy nginx config (proxies /clickhouse to ClickHouse)
+COPY docker/nginx.conf /etc/nginx/nginx.conf
+
+# Copy ClickHouse user config (read-only viewer user)
+COPY docker/users.xml /etc/clickhouse-server/users.d/viewer.xml
+
+# Copy supervisor config (runs both nginx and ClickHouse)
+COPY docker/supervisord.conf /etc/supervisor/conf.d/supervisord.conf
+
+# Expose only web port (ClickHouse internal only)
+EXPOSE 80
+
+# Start supervisor (manages nginx + ClickHouse)
+CMD ["/usr/bin/supervisord", "-c", "/etc/supervisor/conf.d/supervisord.conf"]

README.md

@@ -1,6 +1,6 @@
 # RowBinary Visualizer
 
-A web-based tool for visualizing ClickHouse RowBinary data, similar to ImHex. Features an interactive hex viewer with AST-based type visualization.
+A web-based tool for visualizing ClickHouse RowBinary data, similar to ImHex. Features an interactive hex viewer with AST-based type visualization. 100% vibecoded with Claude Code.
 
 ![Screenshot](.static/screenshot.png)
 
@@ -11,7 +11,20 @@ A web-based tool for visualizing ClickHouse RowBinary data, similar to ImHex. Fe
 - **Interactive Highlighting**: Selecting a node in the tree highlights corresponding bytes in the hex view (and vice versa)
 - **Full Type Support**: All ClickHouse types including Variant, Dynamic, JSON, Geo types, Nested, etc.
 
-## Setup
+## Quick Start (Docker)
+
+Run with bundled ClickHouse server:
+
+```bash
+docker build -t rowbinary-explorer .
+docker run -d -p 8080:80 rowbinary-explorer
+```
+
+Open http://localhost:8080
+
+## Development Setup
+
+For local development (requires ClickHouse at `localhost:8123`):
 
 ```bash
 npm install

docker/nginx.conf

@@ -0,0 +1,32 @@
+events {
+    worker_connections 1024;
+}
+
+http {
+    include       /etc/nginx/mime.types;
+    default_type  application/octet-stream;
+
+    server {
+        listen 80;
+        server_name localhost;
+        root /var/www/html;
+        index index.html;
+
+        # Serve static files
+        location / {
+            try_files $uri $uri/ /index.html;
+        }
+
+        # Proxy /clickhouse to ClickHouse server
+        location /clickhouse {
+            rewrite ^/clickhouse(.*) $1 break;
+            proxy_pass http://127.0.0.1:8123;
+            proxy_set_header Host $host;
+            proxy_set_header X-Real-IP $remote_addr;
+
+            # Use the read-only viewer user
+            proxy_set_header X-ClickHouse-User viewer;
+            proxy_set_header X-ClickHouse-Key "";
+        }
+    }
+}

docker/supervisord.conf

@@ -0,0 +1,21 @@
+[supervisord]
+nodaemon=true
+user=root
+
+[program:clickhouse]
+command=/entrypoint.sh
+autostart=true
+autorestart=true
+stdout_logfile=/dev/stdout
+stdout_logfile_maxbytes=0
+stderr_logfile=/dev/stderr
+stderr_logfile_maxbytes=0
+
+[program:nginx]
+command=/usr/sbin/nginx -g "daemon off;"
+autostart=true
+autorestart=true
+stdout_logfile=/dev/stdout
+stdout_logfile_maxbytes=0
+stderr_logfile=/dev/stderr
+stderr_logfile_maxbytes=0

docker/users.xml

@@ -0,0 +1,19 @@
+<?xml version="1.0"?>
+<clickhouse>
+    <users>
+        <viewer>
+            <password></password>
+            <networks>
+                <ip>::/0</ip>
+            </networks>
+            <profile>readonly</profile>
+            <quota>default</quota>
+            <access_management>0</access_management>
+        </viewer>
+    </users>
+    <profiles>
+        <readonly>
+            <readonly>1</readonly>
+        </readonly>
+    </profiles>
+</clickhouse>