Added clauder user and backward compatibility

Author: sphinxcode

Dockerfile

@@ -36,48 +36,47 @@ RUN curl -fsSL https://deb.nodesource.com/setup_20.x | bash - \
 
 # ============================================================================
 # PERSISTENCE CONFIGURATION
+# BACKWARD COMPATIBLE: Defaults to /home/coder for existing volumes
 # ============================================================================
 
-ENV HOME=/home/clauder
-ENV USER=clauder
+ENV HOME=/home/coder
+ENV USER=coder
 
 # XDG Base Directory Specification
-ENV XDG_DATA_HOME=/home/clauder/.local/share
-ENV XDG_CONFIG_HOME=/home/clauder/.config
-ENV XDG_CACHE_HOME=/home/clauder/.cache
-ENV XDG_STATE_HOME=/home/clauder/.local/state
+ENV XDG_DATA_HOME=/home/coder/.local/share
+ENV XDG_CONFIG_HOME=/home/coder/.config
+ENV XDG_CACHE_HOME=/home/coder/.cache
+ENV XDG_STATE_HOME=/home/coder/.local/state
 
 # PATH: Volume paths FIRST (user installs), image paths LAST (fallbacks)
-ENV PATH="/home/clauder/.local/bin:/home/clauder/.local/node/bin:/home/clauder/.claude/local:/home/clauder/node_modules/.bin:/usr/local/bin:/usr/bin:/usr/lib/code-server/lib/vscode/bin/remote-cli:${PATH}"
+ENV PATH="/home/coder/.local/bin:/home/coder/.local/node/bin:/home/coder/.claude/local:/home/coder/node_modules/.bin:/usr/local/bin:/usr/bin:/usr/lib/code-server/lib/vscode/bin/remote-cli:${PATH}"
 
 # Custom startup scripts directory
-ENV ENTRYPOINTD=/home/clauder/entrypoint.d
+ENV ENTRYPOINTD=/home/coder/entrypoint.d
 
 # ============================================================================
 # USER SETUP
-# Create clauder user with same UID as coder for compatibility
+# The base image already has coder user with UID 1000
 # ============================================================================
 
-RUN groupadd -g 1000 clauder 2>/dev/null || true \
-    && useradd -m -s /bin/bash -u 1000 -g 1000 clauder 2>/dev/null || true \
-    && usermod -l clauder coder 2>/dev/null || true \
-    && groupmod -n clauder coder 2>/dev/null || true
+# Ensure coder user exists with correct UID/GID
+RUN id -u coder &>/dev/null || useradd -m -s /bin/bash -u 1000 -g 1000 coder 2>/dev/null || true
 
 # ============================================================================
 # DIRECTORY SETUP
 # ============================================================================
 
 RUN mkdir -p \
-    /home/clauder/.local/share \
-    /home/clauder/.config \
-    /home/clauder/.cache \
-    /home/clauder/.local/state \
-    /home/clauder/.local/bin \
-    /home/clauder/.local/node \
-    /home/clauder/.claude \
-    /home/clauder/entrypoint.d \
-    /home/clauder/workspace \
-    && chown -R 1000:1000 /home/clauder
+    /home/coder/.local/share \
+    /home/coder/.config \
+    /home/coder/.cache \
+    /home/coder/.local/state \
+    /home/coder/.local/bin \
+    /home/coder/.local/node \
+    /home/coder/.claude \
+    /home/coder/entrypoint.d \
+    /home/coder/workspace \
+    && chown -R 1000:1000 /home/coder
 
 # Copy our custom entrypoint (replaces base image's entrypoint)
 COPY railway-entrypoint.sh /usr/bin/railway-entrypoint.sh
@@ -101,8 +100,9 @@ RUN curl -fsSL https://claude.ai/install.sh | bash \
 # Stay as root - entrypoint handles user switching based on RUN_AS_USER
 # ============================================================================
 
-WORKDIR /home/clauder/workspace
+WORKDIR /home/coder/workspace
 EXPOSE 8080
 
 # Use our entrypoint which calls code-server directly
 ENTRYPOINT ["/usr/bin/railway-entrypoint.sh"]
+

README.md

@@ -1,102 +1,75 @@
-# Claude Code Server
+# VSCode Cloud IDE
 
-**Browser-based VS Code with Claude Code & AI Coding Assistants**
+**Browser-based VSCode with Claude Code & Node.js**
 
-[![Deploy on Railway](https://railway.com/button.svg)](https://railway.com/template/claude-code-server)
+[![Deploy on Railway](https://railway.com/button.svg)](https://railway.com/template/TEMPLATE_ID)
 
-Cloud IDE with persistent extensions, settings, and tools. Pre-installed Claude Code CLI.
+Cloud IDE with persistent extensions, settings, and tools. Runs as non-root user.
+
+---
+
+## Features
+
+- **Claude Code** & **Node.js 20** pre-installed
+- **Non-root execution** - runs as `clauder` user (UID 1000)
+- Extensions persist across redeployments  
+- Volume permissions auto-fixed on startup
 
 ---
 
 ## Quick Start
 
 ```bash
-# Claude Code with auto-accept
+# Claude Code with auto-accept (for automation)
 claude --dangerously-skip-permissions
 
-# Or use the alias
-claude-auto
-
 # Interactive mode
 claude
+
+# Node.js ready
+node --version
+npm --version
 ```
 
 ---
 
-## ⚠️ Claude Code Authentication
+## Environment Variables
 
-When running `claude` for the first time:
-
-1. The CLI will display an authentication URL
-2. **Copy the URL to a different browser** (not this code-server browser)
-3. Complete the login in that browser
-4. Copy the code displayed after login
-5. Paste the code back into the CLI
-
-Your credentials persist in `~/.claude/` across redeployments.
+| Variable | Required | Default | Description |
+|----------|----------|---------|-------------|
+| `PASSWORD` | Yes | - | Login password |
+| `CLAUDER_HOME` | **Yes** | `/home/clauder` | Volume mount path (REQUIRED) |
+| `CLAUDER_UID` | No | `1000` | User ID |
+| `CLAUDER_GID` | No | `1000` | Group ID |
 
 ---
 
-## 📍 Railway Deployment
-
-> **Region**: Set your Railway region to **US West** for the fastest performance.
-
-### Required Variables
-
-| Variable | Description |
-|----------|-------------|
-| `PASSWORD` | Login password for code-server |
-
-### User Configuration
-
-| Variable | Default | Description |
-|----------|---------|-------------|
-| `CLAUDER_HOME` | `/home/clauder` | Volume mount path |
-| `CLAUDER_UID` | `1000` | User ID for clauder |
-| `CLAUDER_GID` | `1000` | Group ID for clauder |
-| `RUN_AS_USER` | `root` | Set to `clauder` for non-root execution |
-
-### Pre-Install AI CLIs
-
-Set to `1` to install on startup (default: `0`):
-
-| Variable | CLI | Description |
-|----------|-----|-------------|
-| `INSTALL_OPENCODE` | OpenCode | Google's agentic AI IDE |
-| `INSTALL_GEMINI` | Gemini CLI | Google Gemini assistant |
-| `INSTALL_KILOCODE` | KiloCode | VS Code AI coding |
-| `INSTALL_CONTINUE` | Continue | Open-source AI code assistant |
-| `INSTALL_CODEX` | Codex | OpenAI Codex CLI |
-
-> **Note**: Claude Code is **always installed** and cannot be disabled.
+## How It Works
 
-### Pre-Install Development Frameworks
+1. **Starts as root** - fixes volume permissions
+2. **Switches to clauder** - uses `gosu` for clean handoff
+3. **Runs code-server** - as non-root user
 
-| Variable | Framework | Description |
-|----------|-----------|-------------|
-| `INSTALL_BMAD` | BMAD Method | Spec-driven development workflow |
-| `INSTALL_OPENSPEC` | OpenSpec | AI-powered spec generation |
-| `INSTALL_SPECKIT` | Spec-Kit | GitHub's specification toolkit |
+This means:
+- ✅ No root permission warnings in code-server
+- ✅ Existing volumes with root-owned files work fine
+- ✅ Claude `--dangerously-skip-permissions` works
 
 ---
 
-## How It Works
+## Claude Code Authentication
 
-1. **Starts as root** – fixes volume permissions
-2. **Installs optional CLIs** – based on environment variables
-3. **Switches to clauder** – uses `gosu` for clean handoff
-4. **Runs code-server** – as non-root user
+After running `claude` for the first time:
 
-This means:
-- ✅ No root permission warnings
-- ✅ Existing volumes work fine
-- ✅ Claude `--dangerously-skip-permissions` works
+1. Follow the authentication prompts
+2. Your credentials are stored in `~/.claude/`
+3. They persist across redeployments (on volume)
 
 ---
 
 ## Custom Startup Scripts
 
-Add scripts to `$CLAUDER_HOME/entrypoint.d/`:
+Add to `$CLAUDER_HOME/entrypoint.d/`:
 
 ```bash
 #!/bin/bash
@@ -111,7 +84,7 @@ Make executable: `chmod +x script.sh`
 
 | Component | Behavior |
 |-----------|----------|
-| **Volume tools** | You control – install to `~/.local/bin/` |
+| **Volume tools** | You control - install to `~/.local/node/` or `~/.claude/local/` |
 | **Image tools** | Auto-update on redeploy (fallback) |
 | **Extensions** | Persist on volume |
 | **Claude auth** | Persists on volume |
@@ -127,7 +100,6 @@ Logs show `[volume]` or `[image]` next to each tool.
 | Permission denied | Check `CLAUDER_UID` matches your volume owner |
 | Claude not found | Run `which claude` to check PATH |
 | Extensions missing | Verify volume mounted at `CLAUDER_HOME` |
-| Auth URL won't open | Copy URL to a different browser |
 
 ---