{"id":49309,"date":"2025-05-12T13:42:19","date_gmt":"2025-05-12T13:42:19","guid":{"rendered":"https:\/\/www.devopsschool.com\/blog\/?p=49309"},"modified":"2025-07-12T05:38:39","modified_gmt":"2025-07-12T05:38:39","slug":"how-to-assign-a-static-ip-to-a-docker-container-in-bridge-mode","status":"publish","type":"post","link":"https:\/\/www.devopsschool.com\/blog\/how-to-assign-a-static-ip-to-a-docker-container-in-bridge-mode\/","title":{"rendered":"How to Assign a Static IP to a Docker Container in Bridge Mode"},"content":{"rendered":"\n

In this guide, you’ll learn how to assign a static IP address<\/strong> to a Docker container using a custom bridge network<\/strong>. This IP address will remain fixed<\/strong> even after your host system reboots<\/strong>.<\/p>\n\n\n\n

\n\n\n\n

\u2705 Why You Need This<\/h2>\n\n\n\n

By default, Docker assigns dynamic IPs to containers via its bridge<\/code> network. If you restart your server or container, the IP may change \u2014 which breaks networking for apps relying on fixed addresses.<\/p>\n\n\n\n

This tutorial helps solve that by:<\/p>\n\n\n\n

    \n
  • Creating a custom bridge network<\/li>\n\n\n\n
  • Assigning a fixed IP<\/li>\n\n\n\n
  • Enabling auto-restart after reboot<\/li>\n<\/ul>\n\n\n\n
    \n\n\n\n

    \ud83e\uddf0 Prerequisites<\/h2>\n\n\n\n
      \n
    • Docker installed on your Linux system (docker -v<\/code> to verify)<\/li>\n\n\n\n
    • Root or sudo access<\/li>\n<\/ul>\n\n\n\n
      \n\n\n\n

      \ud83d\udd27 Step 1: Create a Custom Bridge Network<\/h2>\n\n\n\n

      The default Docker bridge does not<\/strong> support static IP assignment. So, first create a custom one:<\/p>\n\n\n

      docker network create \\\n  --driver bridge \\\n  --subnet 192.168.100.0\/24 \\\n  --gateway 192.168.100.1 \\\n  my_custom_bridge\n<\/code><\/span><\/pre>\n\n\n
      \u2705 This creates a new Docker bridge network:<\/p>\n\n\n\n
        \n
      • Subnet: 192.168.100.0\/24<\/code><\/li>\n\n\n\n
      • Gateway: 192.168.100.1<\/code><\/li>\n\n\n\n
      • Name: my_custom_bridge<\/code><\/li>\n<\/ul>\n\n\n\n
        \n\n\n\n
        \ud83d\ude80 Step 2: Run a Container with a Static IP<\/h2>\n\n\n\n
        Now, start your container with a fixed IP<\/strong> and auto-restart policy<\/strong>:<\/p>\n\n\n
        docker<\/span> run<\/span> -dit<\/span> \\\n  --name<\/span> my_httpd<\/span> \\\n  --network<\/span> my_custom_bridge<\/span> \\\n  --ip<\/span> 192.168<\/span>.100<\/span>.10<\/span> \\\n  --restart<\/span> unless-stopped<\/span> \\\n  httpd<\/span>\n<\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
        \u2705 This ensures:<\/p>\n\n\n\n
          \n
        • 192.168.100.10<\/code> is always assigned<\/li>\n\n\n\n
        • The container restarts after reboot<\/li>\n\n\n\n
        • It uses your custom bridge<\/li>\n<\/ul>\n\n\n\n
          \n\n\n\n
          \ud83d\udd04 Step 3: Test Persistence After Reboot<\/h2>\n\n\n\n
          Reboot your host system:<\/p>\n\n\n
          sudo reboot\n<\/code><\/span><\/pre>\n\n\n
          After the reboot, run:<\/p>\n\n\n
          docker ps\ndocker inspect my_httpd | grep IPAddress\n<\/code><\/span><\/pre>\n\n\n
          \u2705 You should see your container up and running with the same IP.<\/p>\n\n\n\n
          \n\n\n\n
          \ud83d\udcdd Additional Notes<\/h2>\n\n\n\n
            \n
          • Avoid IP conflicts<\/strong> by managing assigned IPs manually.<\/li>\n\n\n\n
          • You can replace httpd<\/code> with any image (e.g., nginx<\/code>, mysql<\/code>, your-custom-app<\/code>).<\/li>\n\n\n\n
          • Use docker network inspect my_custom_bridge<\/code> to check connected containers.<\/li>\n<\/ul>\n\n\n\n
            \n\n\n\n
            \ud83e\udde0 Bonus Tip: Docker Compose Version<\/h2>\n\n\n\n
            Create a docker-compose.yml<\/code>:<\/p>\n\n\n
            version: '3.7'<\/span>\nservices<\/span>:\n  web:\n    image: httpd\n    container_name<\/span>: my_httpd\n    restart<\/span>: unless-stopped\n    networks<\/span>:\n      mynet:\n        ipv4_address: 192.168<\/span>.100<\/span>.10<\/span>\n\nnetworks<\/span>:\n  mynet:\n    driver: bridge\n    ipam<\/span>:\n      config:\n        - subnet: 192.168<\/span>.100<\/span>.0<\/span>\/24<\/span>\n          gateway<\/span>: 192.168<\/span>.100<\/span>.1<\/span>\n<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
            Then run:<\/p>\n\n\n
            docker-compose up -d\n<\/code><\/span><\/pre>\n\n\n
            \n\n\n\n
            \u2705 Conclusion<\/h2>\n\n\n\n
            You\u2019ve now:<\/p>\n\n\n\n
              \n
            • Created a custom Docker network<\/li>\n\n\n\n
            • Assigned a static IP to a container<\/li>\n\n\n\n
            • Ensured it persists across reboots<\/li>\n<\/ul>\n\n\n\n
              This is especially helpful for microservices, reverse proxies, and apps that require stable internal networking.<\/p>\n\n\n\n
              \n\n\n\n
              <\/p>\n","protected":false},"excerpt":{"rendered":"
              In this guide, you’ll learn how to assign a static IP address to a Docker container using a custom bridge network. This IP address will remain fixed even after your… <\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"","sticky":false,"template":"","format":"standard","meta":{"_joinchat":[],"footnotes":""},"categories":[4862],"tags":[],"class_list":["post-49309","post","type-post","status-publish","format-standard","hentry","category-docker"],"_links":{"self":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/49309","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/comments?post=49309"}],"version-history":[{"count":1,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/49309\/revisions"}],"predecessor-version":[{"id":49310,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/49309\/revisions\/49310"}],"wp:attachment":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/media?parent=49309"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/categories?post=49309"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/tags?post=49309"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}