Skip to content

Docker

Jump to bottom
wildfirebill edited this page Aug 25, 2026 · 4 revisions

Docker

Quick Start

docker compose up

Open http://localhost:4801.

Docker Compose

services:
  editor:
    build: .
    ports:
      - "4801:4801"
    volumes:
      - ./:/workspace          # Mount your code
      - localai-data:/data     # Persistent data

Standalone Docker

docker build -t localai-code-editor .
docker run -p 4801:4801 \
  -v $(pwd):/workspace \
  -v localai-data:/data \
  localai-code-editor

Multi-Architecture

The Docker image supports both linux/amd64 and linux/arm64:

docker buildx build --platform linux/amd64,linux/arm64 -t localai-code-editor .

Image Tags

Published to GHCR: ghcr.io/wildfirebill-ai/localai-code-editor

Tag Description
latest Most recent release
X.Y.Z Specific version
X.Y Latest patch for minor
sha-abc1234 Specific commit

Unraid

  1. Open the Unraid Docker tab
  2. Click "Add Container"
  3. Set the repository to ghcr.io/wildfirebill-ai/localai-code-editor
  4. Configure ports (4801) and volumes
  5. Apply and start

Unraid Community Apps Template

A template is included in the repository at unraid/localai-code-editor.xml.

Install via Community Apps:

  1. Add the template URL to Community Apps settings: 
    https://raw.githubusercontent.com/wildfirebill-ai/localai-code-editor/main/unraid/localai-code-editor.xml
  2. Search for "LocalAI Code Editor" in the Apps tab
  3. Click Install and configure paths

Or install manually:

  1. Go to the Docker tab in Unraid
  2. Click "Add Container"
  3. Set repository to ghcr.io/wildfirebill-ai/localai-code-editor:latest
  4. Configure paths and ports as shown above

Environment Variables

Variable Default Description
LOCALAI_HOST 0.0.0.0 Server bind address
LOCALAI_PORT 4801 Server port
LOCALAI_WEB_DIST /app/web Web UI dist path
LOCALAI_SKILLS_DIR /app/skills Builtin skills path

Docker Image Details

Multi-Stage Build

Stage 1 (build):  node:22-alpine
  → Install pnpm, dependencies, build all packages

Stage 2 (runtime): node:22-alpine
  → Only copies built artifacts (no node_modules)
  → Single bundled server file (index.cjs)

Security

  • Alpine base with apk upgrade at build time
  • No npm bundled (reduces attack surface)
  • Network-isolated by default
  • No sensitive data in image layers

Health Check

HEALTHCHECK --interval=30s --timeout=5s --retries=3 \
  CMD wget -qO- http://127.0.0.1:4801/ >/dev/null 2>&1 || exit 1

Troubleshooting

Issue Solution
Port in use Change the port mapping: -p 4802:4801
Permission denied Ensure workspace directory is readable
Slow build Use Docker BuildKit: DOCKER_BUILDKIT=1
ARM not working Ensure QEMU is installed for cross-platform builds

Clone this wiki locally