README.md

Theia cpp Docker

A containerized Theia-based C/C++ demo IDE, including commonly used tools:

The included Theia-based IDE application has the following notable features

[deprecated][latest][@theia/cpp] Language-server built-in clang-tidy static analyser integration. Will analyse files opened in the IDE's editors and report problems for configured rules. See README for more details, including related preferences. Note: this LSP client is deprecated and will be replaced once vscode-clangd works well with latest Theia
[next][vscode-clangd] The reference Language Client for clangd
[@theia/cpp-debug] Basic C/C++ debugging support

Run on https://localhost:3000 with the current directory as a workspace:

docker run --security-opt seccomp=unconfined --init -it -p 3000:3000 -v "$(pwd):/home/project:cached" theiaide/theia-cpp:next

Options:

--security-opt seccomp=unconfined enables running without the default seccomp profile to allow cpp debugging. Note: anecdotally I am able to debug without this option now. I am not sure what may have changed recently.
--init injects an instance of tini in the container, that will wait-for and reap terminated processes, to avoid leaking PIDs.

Build image using next Theia packages and strip the Theia application to save space (with reduced debuggability)

docker build --no-cache --build-arg version=next --build-arg strip=true  -t theia-cpp:next .

Build image using latest theia packages (Theia app not stripped)

docker build --no-cache --build-arg version=latest --build-arg -t theia-cpp:latest .

--build-arg strip=true strips the application to save space but with reduced debuggability.
--build-arg LLVM=<version> version of LLVM tools (clang-tools, clangd and clang-tidy) you prefer (defaults to 12). Please set LLVM=9 to build on ppc64le platform.