{"id":182724,"date":"2025-12-05T12:08:26","date_gmt":"2025-12-05T12:08:26","guid":{"rendered":"https:\/\/randomnerdtutorials.com\/?p=182724"},"modified":"2025-12-05T12:08:28","modified_gmt":"2025-12-05T12:08:28","slug":"raspberry-pi-pico-w-static-ip-address-micropython","status":"publish","type":"post","link":"https:\/\/randomnerdtutorials.com\/raspberry-pi-pico-w-static-ip-address-micropython\/","title":{"rendered":"Raspberry Pi Pico W: Set a Static IP Address (MicroPython)"},"content":{"rendered":"\n

Learn how to set a static \/ fixed IP address for your Raspberry Pi Pico W. When your Pico connects to a network, some routers may assign a different IP address each time it reboots. This can be inconvenient if you need to access or communicate with your board using its IP address. In this guide, we\u2019ll show you how to assign a static IP address to your Raspberry Pi Pico W.<\/p>\n\n\n

\n
\"Raspberry<\/figure><\/div>\n\n\n

Recommended reading: <\/strong>Raspberry Pi Pico W: Getting Started with Wi-Fi (MicroPython)<\/a><\/p>\n\n\n\n

Prerequisites<\/h2>\n\n\n\n

To follow this tutorial, you need:<\/p>\n\n\n\n

1)<\/strong> A Raspberry Pi Pico W<\/a><\/strong> or Raspberry Pi Pico 2W<\/strong><\/a> board (these models support Wi-Fi).<\/p>\n\n\n\n

2)<\/strong> MicroPython firmware installed on your Raspberry Pi Pico board, and an IDE to write and upload code. Follow this tutorial: Programming Raspberry Pi Pico using MicroPython<\/a>.<\/p>\n\n\n\n

Setting a Static\/Fixed IP Address on the Raspberry Pi Pico<\/h1>\n\n\n\n

In the case of my network, even if I restart the Raspberry Pi Pico several times, my router will always assign it the same IP address. However, that\u2019s not the case for some other networks. In that scenario, it\u2019s nice to have a way to set a static IP address to your board, so that it doesn\u2019t change every time it resets. <\/p>\n\n\n\n

Additionally, setting a static IP address is also useful for projects that are not connected to your computer or don\u2019t have a way to display the IP address.<\/p>\n\n\n\n

\n

You can use the ifconfig<\/span> method of the network.WLAN<\/span> object to set a static IP address. For example, use the following line after connecting to your network.<\/p>\n\n\n\n

wlan.ifconfig((static_ip, subnet_mask, gateway_ip, dns_server))<\/code><\/pre>\n<\/div><\/div>\n\n\n\n
The following example connects your board to your network and then sets a static IP address.<\/p>\n\n\n
# Rui Santos & Sara Santos - Random Nerd Tutorials\r\n# Complete project details at https:\/\/RandomNerdTutorials.com\/raspberry-pi-pico-w-wi-fi-micropython\/\r\n\r\nimport network\r\nimport time\r\n\r\n# Wi-Fi credentials\r\nssid = 'REPLACE_WITH_YOUR_SSID'\r\npassword = 'REPLACE_WITH_YOUR_PASSWORD'\r\n\r\n# Static IP configuration\r\nstatic_ip = '192.168.1.100'  # Replace with your desired static IP\r\nsubnet_mask = '255.255.255.0'\r\ngateway_ip = '192.168.1.254'\r\ndns_server = '8.8.8.8'\r\n\r\n# Init Wi-Fi Interface\r\nwlan = network.WLAN(network.STA_IF)\r\nwlan.active(True)\r\n\r\n# Connect to your network\r\nwlan.connect(ssid, password)\r\n\r\n# Wait for Wi-Fi connection\r\nconnection_timeout = 10\r\nwhile connection_timeout > 0:\r\n    if wlan.status() >= 3:\r\n        break\r\n    connection_timeout -= 1\r\n    print('Waiting for Wi-Fi connection...')\r\n    time.sleep(1)\r\n\r\n# Set static IP address\r\nwlan.ifconfig((static_ip, subnet_mask, gateway_ip, dns_server))\r\n\r\n# Check if connection is successful\r\nif wlan.status() != 3:\r\n    raise RuntimeError('Failed to establish a network connection')\r\nelse:\r\n    print('Connection successful!')\r\n    network_info = wlan.ifconfig()\r\n    print('IP address:', network_info[0])<\/code><\/pre>\n\t
View raw code<\/a><\/p>\n\n\n\n
Static IP Configuration<\/h3>\n\n\n\n
Replace the values in the static_ip<\/span>, subnet_mask<\/span>, gateway_ip<\/span>, and dns_server<\/span> variables with the appropriate values for your network.<\/p>\n\n\n\n
# Static IP configuration\nstatic_ip = '192.168.1.100'  # Replace with your desired static IP\nsubnet_mask = '255.255.255.0'\ngateway_ip = '192.168.1.254'\ndns_server = '8.8.8.8'<\/code><\/pre>\n\n\n\n
How to find those values?<\/h4>\n\n\n\n
There are different ways to get information about the subnet mask and the gateway IP. The easiest way is to open a Terminal window on your computer and run the following command:<\/p>\n\n\n\n
On Windows:<\/p>\n\n\n\n
ipconfig<\/code><\/pre>\n\n\n\n
On MacOS or Linux: <\/p>\n\n\n\n
ifconfig<\/code><\/pre>\n\n\n
\n
\"ipconfig<\/figure><\/div>\n\n\n
It will return the information you\u2019re looking for: the gateway IP (the IP address of your router) and the subnet mask.<\/p>\n\n\n
\n
\"ipconfig<\/figure><\/div>\n\n\n
In my case, the subnet mask is 255.255.255.0<\/strong> and the gateway IP address is 192.168.1.254<\/strong>.<\/p>\n\n\n\n
For the DNS server, you can always use 8.8.8.8<\/strong>, which is Google\u2019s public DNS server.<\/p>\n\n\n\n
When choosing the static IP address for your Raspberry Pi Pico, make sure that the address is not already being used by another device. To do that, you can use software like Angry IP Scanner (compatible with Windows and Mac OS). Or you can login to your router dashboard and check which IP addresses are already assigned.<\/p>\n\n\n\n
Setting a Static IP Address<\/h3>\n\n\n\n
After assigning the proper values for the configuration variables, we can simply use the ifconfig()<\/span> method and pass as arguments the static IP, the subnet mask, the gateway IP, and the DNS server, in this order.<\/p>\n\n\n\n
wlan.ifconfig((static_ip, subnet_mask, gateway_ip, dns_server))<\/code><\/pre>\n\n\n\n
Inserting Your Network Credentials<\/h3>\n\n\n\n
To test this code, don’t forget to insert your network credentials in the following lines so that your board can connect to your router:<\/p>\n\n\n\n
ssid = 'REPLACE_WITH_YOUR_SSID'\npassword = 'REPLACE_WITH_YOUR_PASSWORD'<\/code><\/pre>\n\n\n\n
Testing the Code<\/h3>\n\n\n\n
After inserting your network credentials and desired IP address settings, you can run the code on your Raspberry Pi Pico.<\/p>\n\n\n\n
Notice that it will have the IP address you defined in the code. In our case, 192.168.1.100<\/strong>.<\/p>\n\n\n
\n
\"Raspberry<\/figure><\/div>\n\n\n
You can also check your router’s dashboard or AngryIP Scanner to confirm that your RPi Pico has been assigned the IP address you chose.<\/p>\n\n\n
\n
\"Raspberry<\/figure><\/div>\n\n\n
Restart your board, and check that it remains with the same IP address.<\/p>\n\n\n\n
Wrapping Up<\/h2>\n\n\n\n
This was a quick guide showing you how you can modify your MicroPython scripts to set a static\/fixed IP address to your Raspberry Pi Pico. We have other Wi-Fi and network-related guides for the Raspberry Pi Pico that you may like:<\/p>\n\n\n\n