code-container

A portable, lightweight development environment that integrates code-server (VS Code in the browser) with a fully native LLVM toolchain.

This container provides a clean and secure coding environment for C++ and Python 3 without cluttering your host operating system.

• Native LLVM Stack: Pre-configured to use clang++, lld, and libc++ natively, bypassing GCC/GNU toolchain dependencies.
• Permission Sync (Zero-Config): Automatically matches the container user's UID/GID with the host directory's owner, eliminating host-container file permission issues.
• Secure by Default: Designed to run with a read-only root filesystem (--read-only) to reduce the attack surface.

• C++: Clang, lld, lldb, libc++, clangd, clang-format, clang-tidy.
• Python 3: python3, pip, venv, Ruff.
• Build Tools: CMake, Ninja, Git.

mkdir -p workspace
docker run -d \
  --name devenv \
  --read-only \
  --tmpfs /tmp:exec \
  -e LOG=ON \ # or -e LOG=OFF; If omitted, LOG=ON
  -v $(pwd)/workspace:/home \
  -p 3000:3000 \
  ghcr.io/igastorm/code-container:latest

After starting, open your browser and navigate to http://localhost:3000 to start coding.

• The scripts, Dockerfiles, and configuration files in this repository are licensed under the MIT License.
• Third-party software components bundled inside the distributed container image (including but not limited to Clang/LLVM, code-server, Python, GoogleTest, and various VS Code extensions) are governed by their respective original upstream licenses. Please respect and adhere to their respective license terms.