Debugging C/C++ Programs Remotely Using Visual Studio Code and gdbserver

Spencer Elliott
Nov 23, 2016 · 4 min read

1. Install gdbserver on the remote machine

remote$ apt-get install gdbserver
remote$ brew install gdbserver

2. Install gdb on your local machine

local$ brew install gdb --with-all-targets

3. Test gdb

local$ ssh -L9091:localhost:9091 user@remote
remote$ cd ./myproject/ && make
remote$ gdbserver :9091 ./myprogram
local$ gdb
GNU gdb (GDB) 7.12
Copyright (C) 2016 Free Software Foundation, Inc.
For help, type "help".
Type "apropos word" to search for commands related to "word".
(gdb) target remote localhost:9091
Remote debugging using localhost:9091

4. codesign gdb

5. Synchronize local and remote file systems

local$ mkdir ./myproject
local$ sshfs user@remote:myproject ./myproject

6. Configure Visual Studio Code

"version": "0.2.0",
"configurations": [
"name": "C++ Launch",
"type": "cppdbg",
"request": "launch",
"program": "${workspaceRoot}/myprogram",
"miDebuggerServerAddress": "localhost:9091",
"args": [],
"stopAtEntry": false,
"cwd": "${workspaceRoot}",
"environment": [],
"externalConsole": true,
"linux": {
"MIMode": "gdb"
"osx": {
"MIMode": "gdb"
"windows": {
"MIMode": "gdb"
local$ gdb ./myprogram
(gdb) target remote localhost:9091

7. Write a script to compile your program and launch gdbserver

# Kill gdbserver if it's running
ssh user@remote killall gdbserver &> /dev/null
# Compile myprogram and launch gdbserver, listening on port 9091
ssh \
-L9091:localhost:9091 \
user@remote \
"zsh -l -c 'cd myproject && make && gdbserver :9091 ./myprogram'"

8. Start debugging

Spencer Elliott

Written by

Developer @ Microsoft, OneDrive Web

Welcome to a place where words matter. On Medium, smart voices and original ideas take center stage - with no ads in sight. Watch
Follow all the topics you care about, and we’ll deliver the best stories for you to your homepage and inbox. Explore
Get unlimited access to the best stories on Medium — and support writers while you’re at it. Just $5/month. Upgrade