{"id":25081014,"url":"https://github.com/codenkoffee/ros2-humble-docker-development-environment","last_synced_at":"2026-02-14T02:03:51.162Z","repository":{"id":275468833,"uuid":"926167913","full_name":"CodeNKoffee/ROS2-humble-docker-development-environment","owner":"CodeNKoffee","description":null,"archived":false,"fork":false,"pushed_at":"2025-02-03T04:30:19.000Z","size":11,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-09-23T22:02:19.927Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/CodeNKoffee.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-02-02T17:58:50.000Z","updated_at":"2025-02-03T04:30:22.000Z","dependencies_parsed_at":"2025-02-02T19:18:43.110Z","dependency_job_id":"5ff7a829-8ede-4b7f-9466-a06d4d5aad39","html_url":"https://github.com/CodeNKoffee/ROS2-humble-docker-development-environment","commit_stats":null,"previous_names":["codenkoffee/ros2-humble-docker-development-environment"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/CodeNKoffee/ROS2-humble-docker-development-environment","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CodeNKoffee%2FROS2-humble-docker-development-environment","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CodeNKoffee%2FROS2-humble-docker-development-environment/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CodeNKoffee%2FROS2-humble-docker-development-environment/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CodeNKoffee%2FROS2-humble-docker-development-environment/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CodeNKoffee","download_url":"https://codeload.github.com/CodeNKoffee/ROS2-humble-docker-development-environment/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CodeNKoffee%2FROS2-humble-docker-development-environment/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29431593,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-13T22:20:51.549Z","status":"online","status_checked_at":"2026-02-14T02:00:07.626Z","response_time":53,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":[],"created_at":"2025-02-07T04:36:17.397Z","updated_at":"2026-02-14T02:03:51.135Z","avatar_url":"https://github.com/CodeNKoffee.png","language":"Dockerfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ROS2 Humble on macOS - Super Easy Guide! 🚀\n\nHey there! This guide will help you set up ROS2 Humble on your Mac using Docker. Don't worry if some terms sound new - we'll go through everything step by step! \n\n## What You Need First 🎯\n\n1. A Mac computer (either Intel or M1/M2)\n2. Internet connection\n3. Some free space on your computer (at least 10GB)\n\n## Step 1: Installing Docker Desktop 🐳\n\n1. Download Docker Desktop:\n   - Go to [Docker Desktop for Mac](https://www.docker.com/products/docker-desktop/)\n   - Click the big blue Download button\n   - Choose Mac with Apple Chip (M1/M2) or Mac with Intel Chip based on your computer\n\n2. Install Docker Desktop:\n   - Find the downloaded file in your Downloads folder\n   - Double click it\n   - Drag the Docker icon to Applications folder\n   - Open Docker from your Applications folder\n   - Click through any permission requests (enter your password if asked)\n   - Wait until you see \"Docker Desktop is running\" with a green light\n\n## Step 2: Getting Our ROS2 Files 📁\n\n1. Open Terminal:\n   - Press Command(⌘) + Space\n   - Type \"Terminal\"\n   - Press Enter\n\n2. Get the files:\n   ```bash\n   # Make a folder for your robot stuff\n   cd ~/Documents\n   mkdir robot_projects\n   cd robot_projects\n\n   # Get our ROS2 files\n   git clone https://github.com/CodeNKoffee/ROS2-humble-docker-development-environment.git ros2_project\n   cd ros2_project\n   ```\n\n## Step 3: Building Our Robot Container 🤖\n\nStill in Terminal, type these commands:\n\n```bash\n# Build our custom ROS2 container\ndocker compose build\n\n# This might take a few minutes - perfect time for a snack! 🍪\n```\n\n## Step 4: Starting ROS2 🎮\n\n```bash\n# Start the container\ndocker compose up -d\n\n# Enter the container (this is like entering your robot's brain!)\ndocker compose exec ros2_dev bash\n```\n\n## Step 5: Testing Everything Works 🧪\n\nNow you're inside the container (you'll see a different-looking prompt). Let's test it:\n\n```bash\n# Test 1: Basic ROS2 command\nros2 topic list\n\n# Test 2: Run a talker node\nros2 run demo_nodes_cpp talker\n```\n\nOpen a new Terminal window and type:\n```bash\n# Enter the container again\ndocker compose exec ros2_dev bash\n\n# Run a listener node\nros2 run demo_nodes_cpp listener\n```\n\nIf you see messages being passed between talker and listener - Congratulations! 🎉 Everything is working!\n\n## Common Problems and Solutions 🔧\n\n### If Docker Won't Start\n- Make sure Docker Desktop is running (look for the whale icon at the top of your screen)\n- Try restarting Docker Desktop\n\n### If Container Won't Start\n```bash\n# Try these commands:\ndocker compose down\ndocker compose up -d\n```\n\n### If You Can't Enter the Container\n```bash\n# Make sure it's running:\ndocker compose ps\n\n# If nothing shows up:\ndocker compose up -d\n```\n\n## Useful Commands to Remember 📝\n\n```bash\n# Start everything\ndocker compose up -d\n\n# Enter the container\ndocker compose exec ros2_dev bash\n\n# Stop everything\ndocker compose down\n\n# Rebuild if you change something\ndocker compose build\n```\n\n## Need Help? 🆘\n\n- Check if Docker Desktop is running\n- Make sure you're in the right folder (use `pwd` to check)\n- Try turning it off and on again (seriously, it often works!)\n- Ask for help in our community!\n\n## Want to Learn More? 📚\n\n- [ROS2 Tutorials](https://docs.ros.org/en/humble/Tutorials/Beginner-CLI-Tools/Understanding-ROS2-Nodes/Understanding-ROS2-Nodes.html)\n- [Docker Basics](https://docs.docker.com/get-started/)\n- [Our Project Wiki](your-wiki-url)\n\nRemember: Everyone was a beginner once! Don't be afraid to ask questions and experiment. Happy robotics! 🤖\n\n## Quick Commands Reference Card 🗂\n\nCut out this section and keep it handy!\n```bash\n# Start everything\ndocker compose up -d\n\n# Enter ROS2\ndocker compose exec ros2_dev bash\n\n# Stop everything\ndocker compose down\n\n# Check if it's running\ndocker compose ps\n\n# Rebuild everything\ndocker compose build\n```\n\nGood luck with your robot adventures! 🚀\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodenkoffee%2Fros2-humble-docker-development-environment","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcodenkoffee%2Fros2-humble-docker-development-environment","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodenkoffee%2Fros2-humble-docker-development-environment/lists"}