Remote Development Environment for CLion

Warning: Development continues in invasy/dev-env repository.

Toolchain

• clang/llvm 13
• CMake 3.20.5
• ninja 1.10.2
• GNU Make 4.2.1
• GNU Debugger (gdb) with gdbserver 9.2
• rsync 3.1.3
• OpenSSH server 8.2p1
• Ubuntu 20.04 LTS (Focal Fossa)

Note: CMake versions 3.21.* are not supported by CLion versions up to 2021.2.*.

Usage

1. Run service (container).
2. Set up CLion toolchain.
3. Build, run, debug your project in the container.

Run container

docker run -d --cap-add=sys_admin --name=clang_remote -p 127.0.0.1:22001:22 invasy/clang-remote:latest

or from git repository:

docker-compose up -d

CLion Configuration

Toolchains

• Name: clang-remote
• Credentials: see SSH Configurations below
• CMake: /usr/local/bin/cmake
• Make: /usr/local/bin/ninja (see also CMake below)
• C Compiler: /usr/bin/clang-13 (should be detected)
• C++ Compiler: /usr/bin/clang++-13 (should be detected)
• Debugger: /usr/bin/gdb (should be detected)

SSH Configurations

• Host: 127.0.0.1
• Port: 22001
• Authentication type: Password
• User name: builder
• Password: builder

CMake

• Profiles:
  • Debug (or any other profile):
    • CMake options: -G Ninja

SSH

Configuration

# ~/.ssh/config
Host clang-remote
User builder
HostName 127.0.0.1
Port 22001
HostKeyAlias clang-remote
StrictHostKeyChecking no
NoHostAuthenticationForLocalhost yes
PreferredAuthentications password
PasswordAuthentication yes
PubkeyAuthentication no

Remove old host key from ~/.ssh/known_hosts after image rebuilding (note HostKeyAlias in config above):

ssh-keygen -f "$HOME/.ssh/known_hosts" -R "clang-remote"

Connection

ssh clang-remote

Password: builder

See Also

• Remote development | CLion
• Using Docker with CLion — The CLion Blog