# ---- Stage 0: QEMU .so + ROM binaries ---- # Downloads arch-specific .so from GitHub Release (e.g. libqemu-xtensa-amd64.so) # and renames to libqemu-xtensa.so so the backend needs no changes. # Local prebuilt files (prebuilt/qemu/) are used if present. FROM ubuntu:22.04 AS qemu-provider RUN apt-get update && apt-get install -y --no-install-recommends curl ca-certificates \ && rm -rf /var/lib/apt/lists/* ARG TARGETARCH ARG QEMU_RELEASE_URL=https://github.com/davidmonterocrespo24/velxio/releases/download/qemu-prebuilt # Copy the prebuilt directory (may contain .so+ROM files or just the .gitkeep) RUN mkdir -p /qemu COPY prebuilt/qemu/ /qemu/ # Download arch-specific .so and arch-independent ROM files RUN cd /qemu \ && for base in libqemu-xtensa libqemu-riscv32; do \ f="${base}.so" ; \ if [ ! -f "$f" ]; then \ echo "Downloading ${base}-${TARGETARCH}.so → $f ..." ; \ curl -fSL -o "$f" "${QEMU_RELEASE_URL}/${base}-${TARGETARCH}.so" ; \ else \ echo "Using local $f ($(stat -c%s "$f") bytes)" ; \ fi ; \ done \ && for f in esp32-v3-rom.bin esp32-v3-rom-app.bin esp32c3-rom.bin; do \ if [ ! -f "$f" ]; then \ echo "Downloading $f ..." ; \ curl -fSL -o "$f" "${QEMU_RELEASE_URL}/$f" ; \ else \ echo "Using local $f ($(stat -c%s "$f") bytes)" ; \ fi ; \ done \ && ls -lh /qemu/ # ---- Stage 0.5: ESP-IDF toolchain for ESP32 compilation ---- FROM ubuntu:22.04 AS espidf-builder RUN apt-get update && apt-get install -y --no-install-recommends \ git wget flex bison gperf python3 python3-pip python3-venv \ cmake ninja-build ccache libffi-dev libssl-dev \ libusb-1.0-0 ca-certificates \ && rm -rf /var/lib/apt/lists/* # Install ESP-IDF 4.4.7 (matches Arduino ESP32 core 2.0.17 / lcgamboa QEMU ROM) RUN git clone -b v4.4.7 --recursive --depth=1 --shallow-submodules \ https://github.com/espressif/esp-idf.git /opt/esp-idf WORKDIR /opt/esp-idf # Install toolchains for esp32 (Xtensa) and esp32c3 (RISC-V) only RUN ./install.sh esp32,esp32c3 # Clean up large unnecessary files to reduce image size RUN rm -rf .git docs examples \ && find /root/.espressif -name '*.tar.*' -delete 2>/dev/null || true # Install Arduino-as-component for full Arduino API support in ESP-IDF builds RUN git clone --branch 2.0.17 --depth=1 --recursive --shallow-submodules \ https://github.com/espressif/arduino-esp32.git /opt/arduino-esp32 \ && rm -rf /opt/arduino-esp32/.git # ---- Stage 1: Build frontend and third-party ---- FROM node:20 AS frontend-builder WORKDIR /app # avr8js, rp2040js and @wokwi/elements are pulled directly from the npm # registry (see frontend/package.json) — no upstream git clones needed. # Board SVGs live in frontend/public/boards/, component SVGs in # frontend/public/component-svgs/, and components-metadata.json is committed. COPY frontend/ frontend/ COPY scripts/ scripts/ WORKDIR /app/frontend # Lock files aren't committed in this repo (they're gitignored) — see the # note in .gitignore. The `rm -f` below is defense-in-depth in case # someone runs `docker build .` from a tree where a local lock exists. RUN rm -f package-lock.json \ && npm install --include=optional \ && npm run build:docker # ---- Stage 2: Final Production Image ---- FROM python:3.12-slim # Install system dependencies, nginx, and QEMU .so runtime libraries RUN apt-get update && apt-get install -y --no-install-recommends \ curl \ ca-certificates \ nginx \ libglib2.0-0 \ libgcrypt20 \ libslirp0 \ libpixman-1-0 \ libfdt1 \ cmake \ ninja-build \ libusb-1.0-0 \ git \ ccache \ && apt-get clean \ && rm -rf /var/lib/apt/lists/* \ && pip install --no-cache-dir packaging # Install arduino-cli into /usr/local/bin directly (avoids touching /bin) RUN curl -fsSL https://raw.githubusercontent.com/arduino/arduino-cli/master/install.sh \ | BINDIR=/usr/local/bin sh # Only install arduino-cli binary here. Core installation (arduino:avr, # rp2040:rp2040) is done at first boot by entrypoint.sh and persisted # in the mounted /root/.arduino15 volume. # ESP32 compilation uses ESP-IDF instead of arduino-cli. WORKDIR /app # Data directory for persistent SQLite database (mounted as a volume at runtime) RUN mkdir -p /app/data # Install Python backend dependencies COPY backend/requirements.txt . RUN pip install --no-cache-dir -r requirements.txt # Copy backend application code COPY backend/app/ ./app/ # One-off maintenance scripts (e.g. backfill_boards_2026_05). Pure stdlib — # run with: docker exec velxio-app python /app/scripts/