{"id":13692479,"url":"https://github.com/devrt/ros-devcontainer-vscode","last_synced_at":"2026-01-26T06:09:57.902Z","repository":{"id":38891351,"uuid":"189168242","full_name":"devrt/ros-devcontainer-vscode","owner":"devrt","description":"ROS dev container for vscode","archived":false,"fork":false,"pushed_at":"2024-06-30T13:16:55.000Z","size":75,"stargazers_count":194,"open_issues_count":12,"forks_count":51,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-05-02T19:42:48.398Z","etag":null,"topics":["cloud-ide","devcontainer","docker","ide","ros","vscode"],"latest_commit_sha":null,"homepage":"","language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/devrt.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-05-29T06:57:25.000Z","updated_at":"2025-04-16T13:04:41.000Z","dependencies_parsed_at":"2024-11-12T18:34:59.712Z","dependency_job_id":"91382439-8a8d-48cc-9d53-9901a596e89a","html_url":"https://github.com/devrt/ros-devcontainer-vscode","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/devrt/ros-devcontainer-vscode","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devrt%2Fros-devcontainer-vscode","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devrt%2Fros-devcontainer-vscode/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devrt%2Fros-devcontainer-vscode/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devrt%2Fros-devcontainer-vscode/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/devrt","download_url":"https://codeload.github.com/devrt/ros-devcontainer-vscode/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devrt%2Fros-devcontainer-vscode/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28768076,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-26T03:54:34.369Z","status":"ssl_error","status_checked_at":"2026-01-26T03:54:33.031Z","response_time":59,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cloud-ide","devcontainer","docker","ide","ros","vscode"],"created_at":"2024-08-02T17:00:58.455Z","updated_at":"2026-01-26T06:09:57.887Z","avatar_url":"https://github.com/devrt.png","language":"Dockerfile","readme":"ROS dev container for VSCode\n----------------------------\nPacked with:\n- Preconfigured docker image for ROS development.\n- Browser accessible X11 server to display gazebo, rviz, rqt (runs on Windows/Mac).\n- Tasks definition to run catkin_make, roscore, rviz commands.\n- Preconfigured code completion for C++, Python, XML (package.xml, launchfiles, URDF, SDF).\n- Preconfigured simulation environments (Flatland, TurtleBot3, ARIAC, Virtual RobotX, UUV).\n- Bonus: WebIDE (code-server) with preconfigured C++, Python, XML completion.\n\nVSCode and devcontainer running on Mac:\n![screenshot](https://user-images.githubusercontent.com/18067/58605055-8dc84980-82d1-11e9-8ee5-dc969fcb2ae1.png)\n\nWebIDE opened from the local browser while devcontainer is running on the remote server:\n![screenshot-theia](https://user-images.githubusercontent.com/18067/59972289-58a8d180-95c7-11e9-86fd-7d271684e8b3.PNG)\n\nHow to select simulation environment\n-------------------------------------\nYou can run preconfigured simulation environment as a docker sidecar container.\n\nEnter following command to select the simulator:\n```shell\n$ ./select-simulator.sh\n```\n\nPreconfigured simulation environment currently includes: Flatland, TurtleBot3, ARIAC, Virtual RobotX, UUV.\n\nSee the following index for list of current simulators:\n\nhttps://github.com/devrt/simulator-index/blob/master/index.yaml\n\nIf you want any other simulator, let us know by submitting the issue:\n\nhttps://github.com/devrt/simulator-index/issues\n\nHow to use the WebIDE (recommended)\n-------------------------------------\nAs of writing, docker-compose support of VSCode is not so stable on all the platforms.\nWe recommend using code-server WebIDE since it has complete VSCode function support.\n\n1. Clone this repository:\n```shell\n$ git clone https://github.com/devrt/ros-devcontainer-vscode.git\n```\n\n2. Enter the following command under the folder of the cloned project:\n```shell\n$ cd ros-devcontainer-vscode\n$ docker-compose up\n```\n\n3. Open http://localhost:3001/ using your favorite browser.\n\nYou can also use remote server to host the devcontainer (run `docker-compose up` on the remote server and open `http://[remote-server]:3001`).\n\nHow to use this dev container with VSCode\n-----------------------------------------\nFirst, you have to install VSCode and Docker for Windows/Mac:\n- https://code.visualstudio.com/\n- https://docs.docker.com/docker-for-mac/\n- https://docs.docker.com/docker-for-windows/\n\nAfter you installed required softwares:\n\n1. Install [\"Remote Development\" extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.vscode-remote-extensionpack) on your VSCode.\n2. Clone this repository by using git command.\n3. Click on the quick actions status bar item (green icon) in the lower left corner of the VSCode.\n4. Select \"Remote-Containers: Open Folder in Container...\" from the command list that appears, and open the root folder of the project you just cloned.\n5. You need to wait a while for container to come up (only required once).\n\nFor detailed instructions, see:\nhttps://code.visualstudio.com/docs/remote/containers\n\nIf you are behind the proxy\n-----------------------------\n\nPlease apply following two settings, if you are using your PC behind the proxy.\n\n1. Proxy setting for the Docker server.\n\nClick Docker Desktop task bar icon \u003e Select `preference` menu item. You will see the following options:\n\n![docker-proxy-settings](https://user-images.githubusercontent.com/18067/59744551-c4302d80-92ad-11e9-9b20-cc873a53a8bb.png)\n\nIn most cases, `System proxy` option will work. But if you have problem downloading the docker images, please try `Manual proxy configuration` option.\n\n2. Proxy setting for the devcontainer.\n\nThis setting will enable you to use the `apt-get` or the other network commands inside the devcontainer.\n\nFirst, open `.env.sample` file under the root folder of the cloned project.\nEdit the settings according to your environment.\nSave the file as name `.env`.\n\nNext, open `docker-compose.yml` file under the root folder of the cloned project and uncomment the following lines:\n```yaml\n  workspace:\n    env_file:\n      - .env\n```\n\nHow to reset or update the devcontainer\n---------------------------------------\n\nIf you want to reset the devcontainer. Please close vscode and enter the following command under the folder of the cloned project:\n```shell\n$ docker-compose down\n```\n\nIf you want to update the environment to the most recent version. Please enter the following commands under the folder of the cloned project:\n```shell\n$ git pull origin master\n$ docker-compose pull\n```\n\nPlease be noticed that the `docker-compose down` command will reset your environment including installed `.deb` packages. However, if you write `package.xml` files correctly, you can reinstall all the depending packages by entering the following two commands:\n```shell\n$ rosdep update\n$ rosdep install --from-paths src --ignore-src -r -y\n```\n\nHow to open X11 server screen\n-----------------------------\n\n1. Wait for the container to start.\n2. Open http://localhost:3000/ using your favorite browser.\n\nIf you are using Docker Toolbox, open the following URL instead:\n\nhttp://192.168.99.100:3000/\n\nIf you want browser screen to be integrated with VS Code, use [Browser Preview for VS Code extension](https://marketplace.visualstudio.com/items?itemName=auchenberg.vscode-browser-preview).\n\nCreated by\n----------\nYosuke Matsusaka (MID Academic Promotions, Inc.)\n\nLicense\n-------\nCode in this repository (Dockerfile, utility scripts, etc) is distributed under Apache 2.0 license.\n\nIncluded components are distributed under each different licenses:\n- Jupyter notebook: BSD","funding_links":[],"categories":["Samples","Dockerfile","vscode"],"sub_categories":["Misc"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevrt%2Fros-devcontainer-vscode","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdevrt%2Fros-devcontainer-vscode","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevrt%2Fros-devcontainer-vscode/lists"}