Skip to content

feat: add Docker deployment support #241

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
FarisHijazi wants to merge 2 commits into
base: main
Choose a base branch
from
Open

feat: add Docker deployment support #241

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
cf5c5b7
feat: add Docker deployment support
FarisHijazi Nov 22, 2025
556e6c9
fix: update compose, removed traefik from it
FarisHijazi Nov 24, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
46 changes: 46 additions & 0 deletions .dockerignore
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,46 @@
# Dependencies
node_modules/
npm-debug.log*
yarn-debug.log*
yarn-error.log*

# Development
.git/
.github/
.vscode/
.idea/

# Build outputs
dist/
build/

# Environment files
.env.local
.env.development
.env.test

# Testing
coverage/
.nyc_output/

# Misc
*.log
*.swp
*.swo
*~
.DS_Store
Thumbs.db

# Documentation
*.md
!README.md

# CI/CD
.github/
.gitlab-ci.yml
.travis.yml

# Docker
#Dockerfile*
#docker-compose*
#.dockerignore
68 changes: 68 additions & 0 deletions Dockerfile
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,68 @@
FROM node:20-alpine AS builder

# Install build dependencies
RUN apk add --no-cache \
python3 \
make \
g++ \
git

WORKDIR /app

# Copy package files
COPY package*.json ./

# Install all dependencies (including dev dependencies for building)
RUN npm ci && \
npm cache clean --force

# Copy source code
COPY . .

# Build frontend
RUN npm run build

# =============================================================================
# Production stage
# =============================================================================
FROM node:20-alpine

# Install runtime dependencies
RUN apk add --no-cache \
python3 \
make \
g++ \
git \
ca-certificates \
tzdata
Comment on lines +31 to +37
Copy link
Contributor

@coderabbitai coderabbitai bot Nov 24, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟠 Major

Remove unnecessary build dependencies from production stage.

The production stage includes build tools (python3, make, g++, git) that are not needed at runtime. These only increase the image size. Keep only runtime dependencies: ca-certificates and tzdata.

Apply this diff to remove build dependencies:

  # Install runtime dependencies
  RUN apk add --no-cache \
-     python3 \
-     make \
-     g++ \
-     git \
-     ca-certificates \
+     ca-certificates \
      tzdata
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
RUN apk add --no-cache \
python3 \
make \
g++ \
git \
ca-certificates \
tzdata
RUN apk add --no-cache \
ca-certificates \
tzdata
🤖 Prompt for AI Agents 
In Dockerfile around lines 31 to 37, the production stage is installing
build-time packages (python3, make, g++, git) that aren't required at runtime;
remove those packages and only install the runtime dependencies ca-certificates
and tzdata to reduce image size. Edit the RUN apk add --no-cache line to drop
python3, make, g++, and git so it only installs ca-certificates and tzdata, and
verify there are no subsequent runtime steps that expect the removed tools.


WORKDIR /app

# Copy package files and install production dependencies
COPY package*.json ./
RUN npm ci --only=production && \
npm cache clean --force

# Copy built files from builder
COPY --from=builder /app/dist ./dist
COPY --from=builder /app/server ./server
COPY --from=builder /app/public ./public
COPY --from=builder /app/index.html ./index.html

# Create necessary directories with proper permissions
RUN mkdir -p /data /config && \
chown -R node:node /app /data /config

# Switch to node user (uid/gid 1000)
USER node

# Environment variables
ENV NODE_ENV=production \
PORT=3001 \
DATABASE_PATH=/data/auth.db

# Expose port
EXPOSE 3001

# Start server
CMD ["node", "server/index.js"]
49 changes: 49 additions & 0 deletions docker-compose.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,49 @@
networks:
claudecodeui:
name: claudecodeui
public:
external: true

services:
claudecodeui:
build:
context: .
dockerfile: Dockerfile
# image: claudecodeui:latest
restart: unless-stopped
ports:
- "${EXTERNAL_PORT:-3002}:3001"
env_file:
- path: ./.env
required: true
environment:
- PORT=${PORT:-3001}
- DATABASE_PATH=${DATABASE_PATH:-/data/auth.db}
- CONTEXT_WINDOW=${CONTEXT_WINDOW:-160000}
- CLAUDE_CLI_PATH=${CLAUDE_CLI_PATH:-claude}
- NODE_ENV=production
volumes:
# sadly these paths must be hardcoded (no we cannot use $HOME) because claude code uses
# hardcoded absolute paths in the ../node/.claude file and Docker must have identical full ones
#- /home/faris/Projects/:/home/faris/Projects/
- ${HOME}/Projects/:${HOME}/Projects/
# - /mnt/d2/Projects/:/mnt/d2/Projects/
- ${HOME}/.claude:/home/node/.claude:rw
- claudecodeui-data:/data
- claudecodeui-config:/config
networks:
- claudecodeui
- public
healthcheck:
test: ["CMD", "node", "-e", "require('http').get('http://localhost:3001/api/health', (r) => {process.exit(r.statusCode === 200 ? 0 : 1)})"]
interval: 30s
timeout: 10s
retries: 3
start_period: 40s

volumes:
claudecodeui-data:
name: claudecodeui_data
claudecodeui-config:
name: claudecodeui_config