ns3d

Docker setup for NS-3 development.

Based on the ns-3-dev | labcomu | Gitlab repository.

Current NS-3 version: 3.43.

Required packages

1. Make
2. Docker Engine
3. Docker Compose
4. Visual Studio Code
5. Visual Studio Code Extension: Dev Containers

Getting started

1. Install required packages
2. Run make to create and enter the ns3 container.
   • If you already did it once, use make it to enter the container again.
3. Open on Visual Studio Code: Dev Containers: Open Attached Container Configuration File... > ns3
   • Also available at /home/$USER/.config/Code/User/globalStorage/ms-vscode-remote.remote-containers/imageConfigs/ns3.json
4. Paste the following content:

{
	"workspaceFolder": "/home/ubuntu/ns-3-dev",
	"remoteUser": "ubuntu",
	"extensions": [
		"ms-vscode.cmake-tools",
		"ms-vscode.cpptools",
		"ms-vscode.cpptools-extension-pack",
		"ms-vscode.cpptools-themes",
		"twxs.cmake"
	]
}

1. Open on Visual Studio Code: Dev Containers: Attach to Running Container... > /ns3
2. Optional: setup GIT user to commit changes.

You are ready to develop and run NS-3 inside a Docker container.

References

• ns-3-dev | labcomu | Gitlab
• NS-3
• ns3-box