{"id":182776,"date":"2026-02-05T12:40:35","date_gmt":"2026-02-05T12:40:35","guid":{"rendered":"https:\/\/randomnerdtutorials.com\/?p=182776"},"modified":"2026-02-05T12:40:38","modified_gmt":"2026-02-05T12:40:38","slug":"raspberry-pi-pico-w-save-network-credentials","status":"publish","type":"post","link":"https:\/\/randomnerdtutorials.com\/raspberry-pi-pico-w-save-network-credentials\/","title":{"rendered":"Raspberry Pi Pico W: Save Network Credentials on a Separate File (MicroPython)"},"content":{"rendered":"\n

In this quick guide for the Raspberry Pi Pico W, you’ll learn how to save your network credentials in a separate file saved on the Pico’s filesystem (in addition to your main.py<\/em> script).<\/p>\n\n\n\n

When creating networking projects, it might be useful to save configuration settings, such as the SSID and password, in a separate file stored on the Pico’s filesystem. Then, you can easily reference that file in your main code to use those credentials. This is not only practical but also prevents you from accidentally sharing your network credentials or sensitive information when sharing your code with a friend or online.<\/p>\n\n\n

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

New to the Raspberry Pi Pico?<\/strong> Start here: Getting Started with Raspberry Pi Pico 2 and Pico 2 W<\/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

Creating a Configuration File<\/h2>\n\n\n\n

1.<\/strong> Open Thonny IDE and establish a connection with your Raspberry Pi Pico W.<\/p>\n\n\n\n

2.<\/strong> Create a new file.<\/p>\n\n\n\n

3.<\/strong> Write the following inside that file, but replace it with your network credentials:<\/p>\n\n\n\n

wifi_ssid = 'REPLACE_WITH_YOUR_SSID'\nwifi_password = 'REPLACE_WITH_YOUR_PASSWORD'<\/code><\/pre>\n\n\n\n
4.<\/strong> Save the file on the Raspberry Pi Pico filesystem. In Thonny IDE, go to File<\/strong> > Save as..<\/strong>. > Raspberry Pi Pico<\/strong> and save the file with the name config.py<\/em><\/span>.<\/p>\n\n\n
\n
\"Save<\/figure><\/div>\n\n
\n
\"Save<\/figure><\/div>\n\n\n
Importing the Network Credentials<\/h2>\n\n\n\n
After creating the file with your network credentials, you can easily import them to your main code as follows:<\/p>\n\n\n\n
from config import wifi_ssid, wifi_password<\/code><\/pre>\n\n\n\n
Then, you can use the wifi_ssid<\/span>, and wifi_password<\/span> variables to initialize Wi-Fi, when calling the wlan.connect()<\/span> function.<\/p>\n\n\n\n
wlan.connect(wifi_ssid, wifi_password)<\/code><\/pre>\n\n\n\n
Web Server with config.py<\/em> File<\/h2>\n\n\n\n
To show you how to apply this in a practical example, here’s a simple “Hello, World” web server script that uses the SSID and password credentials from the external file to connect to the internet.<\/p>\n\n\n
# Rui Santos & Sara Santos - Random Nerd Tutorials\n# Complete project details: https:\/\/RandomNerdTutorials.com\/raspberry-pi-pico-w-save-network-credentials\/\n\nimport network\nimport socket\nimport time\nimport random\n\n# Import SSID and password from the config.py file\nfrom config import wifi_ssid, wifi_password\n\n# HTML template for the webpage\nwebpage = """\n        <!DOCTYPE html>\n        <html>\n        <head>\n            <title>Pico Web Server<\/title>\n            <meta name="viewport" content="width=device-width, initial-scale=1">\n        <\/head>\n        <body>\n            <h1>Raspberry Pi Pico Web Server<\/h1>\n            <p>Hello, World!<\/p>\n        <\/body>\n        <\/html>\n        """\n\n# Init Wi-Fi Interface\ndef init_wifi(ssid, password):\n    wlan = network.WLAN(network.STA_IF)\n    wlan.active(True)\n    # Connect to your network\n    wlan.connect(ssid, password)\n    # Wait for Wi-Fi connection\n    connection_timeout = 10\n    while connection_timeout > 0:\n        if wlan.status() >= 3:\n            break\n        connection_timeout -= 1\n        print('Waiting for Wi-Fi connection...')\n        time.sleep(1)\n    # Check if connection is successful\n    if wlan.status() != 3:\n        return False\n    else:\n        print('Connection successful!')\n        network_info = wlan.ifconfig()\n        print('IP address:', network_info[0])\n        return True\n\nif init_wifi(wifi_ssid, wifi_password):\n    # Set up socket and start listening\n    addr = socket.getaddrinfo('0.0.0.0', 80)[0][-1]\n    s = socket.socket()\n    s.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)\n    s.bind(addr)\n    s.listen()\n    print('Listening on', addr)\n\n# Main loop to listen for connections\nwhile True:\n    try:\n        conn, addr = s.accept()\n        print('Got a connection from', addr)\n\n        # Receive and parse the request\n        request = conn.recv(1024)\n        request_str = request.decode('utf-8')\n        print('Request content:')\n        \n        # Split headers and body\n        headers, body = request_str.split('\\r\\n\\r\\n', 1)\n        print('Headers:\\n', headers)\n        print('Body:\\n', body)\n\n        # Generate HTML response\n        response = webpage\n\n        # Send the HTTP response and close the connection\n        conn.send('HTTP\/1.0 200 OK\\r\\nContent-type: text\/html\\r\\n\\r\\n')\n        conn.send(response)\n        conn.close()\n\n    except OSError as e:\n        conn.close()\n        print('Connection closed')\n<\/code><\/pre>\n\t
View raw code<\/a><\/p>\n\n\n\n
Run this previous code on your Raspberry Pi Pico.<\/p>\n\n\n
\n
\"Thonny<\/figure><\/div>\n\n\n
After a while, it will connect to your network and display its IP address.<\/p>\n\n\n
\n
\"RPi<\/figure><\/div>\n\n\n
You can access the web server on your web browser by typing the IP address.<\/p>\n\n\n
\n
\"Raspberry<\/figure><\/div>\n\n\n
As you can see, there’s no need to insert the credentials in your main code if you have stored them in an external file that is saved on the Pico filesystem and referenced in the main code.<\/p>\n\n\n\n
\n\n\n\n
Saving Multiple Network Credentials<\/h2>\n\n\n\n
Instead of saving a single SSID and password combination, it might be beneficial to use multiple combinations. To do that, you can create a JSON file with multiple SSID and password combinations.<\/p>\n\n\n\n
Creating a JSON File<\/h3>\n\n\n\n
Create a new file on Thonny IDE with the following content.<\/p>\n\n\n\n
[\n    {\"ssid\": \"your_ssid_1\", \"password\": \"your_password_1\"},\n    {\"ssid\": \"your_ssid_2\", \"password\": \"your_password_2\"},\n    {\"ssid\": \"your_ssid_3\", \"password\": \"your_password_3\"}\n]<\/code><\/pre>\n\n\n\n
Replace your_ssid1<\/span> and your_password_1<\/span> with the first SSID and password combination, and so on. You can add as many combinations as you need, or only have one or two.<\/p>\n\n\n\n
Save it on your Raspberry Pi Pico with the name: wifi_credentials.json<\/em><\/span>. In Thonny IDE, go to File <\/strong>> Save as…<\/strong> > Raspberry Pi Pico<\/strong>. Call it wifi_credentials.json<\/em><\/span>.<\/p>\n\n\n
\n
\"RPi-Pico-Saving-JSON-file-with-Wi-Fi-credentials\"<\/figure><\/div>\n\n\n
Connecting to Your Network Using the JSON File<\/h3>\n\n\n\n
With just a few modifications to the previous example, we can use that JSON file to try the different SSID and password combinations. Here\u2019s the modified code:<\/p>\n\n\n
# Rui Santos & Sara Santos - Random Nerd Tutorials\n# Complete project details: https:\/\/RandomNerdTutorials.com\/raspberry-pi-pico-w-save-network-credentials\/\n\nimport network\nimport socket\nimport time\nimport json\n\n# HTML template for the webpage\nwebpage = """\n        <!DOCTYPE html>\n        <html>\n        <head>\n            <title>Pico Web Server<\/title>\n            <meta name="viewport" content="width=device-width, initial-scale=1">\n        <\/head>\n        <body>\n            <h1>Raspberry Pi Pico Web Server<\/h1>\n            <p>Hello, World!<\/p>\n        <\/body>\n        <\/html>\n        """\n\ndef init_wifi_from_file(file_path='wifi_credentials.json'):\n    try:\n        with open(file_path, 'r') as file:\n            credentials = json.load(file)\n    except OSError:\n        print(f"Error: Unable to read {file_path}. Make sure the file exists and is properly formatted.")\n        return False\n\n    for cred in credentials:\n        ssid = cred.get('ssid')\n        password = cred.get('password')\n        if ssid and password:\n            if init_wifi(ssid, password):\n                return True\n\n    print("Unable to connect to any Wi-Fi network.")\n    return False\n\n# Init Wi-Fi Interface\ndef init_wifi(ssid, password):\n    wlan = network.WLAN(network.STA_IF)\n    wlan.active(True)\n    wlan.disconnect()\n\n    print(f"Trying to connect to Wi-Fi network with SSID: {ssid}")\n\n    wlan.connect(ssid, password)\n\n    # Wait for Wi-Fi connection\n    connection_timeout = 10\n    while connection_timeout > 0:\n        if wlan.isconnected():\n            print('Connection successful!')\n            network_info = wlan.ifconfig()\n            print('IP address:', network_info[0])\n            return True\n\n        connection_timeout -= 1\n        print('Waiting for Wi-Fi connection...')\n        time.sleep(1)\n\n    print(f"Failed to connect to Wi-Fi network with SSID: {ssid}")\n    return False\n\n# Set up Wi-Fi\nif not init_wifi_from_file():\n    print("Exiting program.")\nelse:\n    try:\n        # Set up socket and start listening\n        addr = socket.getaddrinfo('0.0.0.0', 80)[0][-1]\n        s = socket.socket()\n        s.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)\n        s.bind(addr)\n        s.listen()\n        print('Listening on', addr)\n\n        # Main loop to listen for connections\n        while True:\n            try:\n                conn, addr = s.accept()\n                print('Got a connection from', addr)\n\n                # Receive and parse the request\n                request = conn.recv(1024)\n                request_str = request.decode('utf-8')\n                print('Request content:')\n                \n                # Split headers and body\n                headers, body = request_str.split('\\r\\n\\r\\n', 1)\n                print('Headers:\\n', headers)\n                print('Body:\\n', body)\n\n                # Generate HTML response\n                response = webpage\n\n                # Send the HTTP response and close the connection\n                conn.send('HTTP\/1.0 200 OK\\r\\nContent-type: text\/html\\r\\n\\r\\n')\n                conn.send(response)\n                conn.close()\n\n            except OSError as e:\n                conn.close()\n                print('Connection closed')\n\n    except KeyboardInterrupt:\n        print('Server stopped by user.')\n<\/code><\/pre>\n\t
View raw code<\/a><\/p>\n\n\n\n
How the Code Works<\/h3>\n\n\n\n
Let\u2019s just take a quick look at the relevant parts for this example.<\/p>\n\n\n\n
We create a new function that will initialize Wi-Fi with the credentials saved in the JSON file.<\/p>\n\n\n\n
def init_wifi_from_file(file_path='wifi_credentials.json'):\n    try:\n        with open(file_path, 'r') as file:\n            credentials = json.load(file)\n    except OSError:\n        print(f\"Error: Unable to read {file_path}. Make sure the file exists\n                   and is properly formatted.\")\n        return False\n    for cred in credentials:\n        ssid = cred.get('ssid')\n        password = cred.get('password')\n        if ssid and password:\n            if init_wifi(ssid, password):\n                return True\n    print(\"Unable to connect to any Wi-Fi network.\")\n    return False<\/code><\/pre>\n\n\n\n
It opens the file and saves the JSON content to the credentials<\/span> variable.<\/p>\n\n\n\n
with open(file_path, 'r') as file:\n    credentials = json.load(file)<\/code><\/pre>\n\n\n\n
Then, we go through all JSON elements, and for each SSID\/password combination, we attempt to connect to Wi-Fi:<\/p>\n\n\n\n
for cred in credentials:\n    ssid = cred.get('ssid')\n    password = cred.get('password')\n    if ssid and password:\n        if init_wifi(ssid, password):\n            return True<\/code><\/pre>\n\n\n\n
Then, before proceeding with the web server, we check if we are able to connect to any of the Wi-Fi networks. If we don\u2019t, it will exit the program.<\/p>\n\n\n\n
# Set up Wi-Fi\nif not init_wifi_from_file():\n    print(\"Exiting program.\")<\/code><\/pre>\n\n\n\n
Otherwise, it will proceed with the rest of the code to create the web server.<\/p>\n\n\n\n
Testing the Example<\/h3>\n\n\n\n
Run this previous example on your board. It will attempt to connect to your network using each SSID and password combination until it gets a connection.<\/p>\n\n\n\n
In my case, to test this example, I purposedly only entered the right credentials in the second option. You can see that it attempts several times to connect using the firt SSID\/password pair. It fails, so it will try the second option.<\/p>\n\n\n
\n
\"Raspberry<\/figure><\/div>\n\n\n
With this second option, it will successfully connect to the network. This approach can be useful if you’re working on your project on different places with different networks.<\/p>\n\n\n\n
Wrapping Up<\/h2>\n\n\n\n
In this quick example, we\u2019ve shown you how to load the Wi-Fi credentials from a separate file. This can be useful because you don\u2019t need to type your credentials in each code you want to test, and it prevents sharing your network credentials accidentally.<\/p>\n\n\n\n
If you want your Raspberry Pi Pico to try more than one combination of SSID\/password, you can create a JSON file with multiple combinations.<\/p>\n\n\n\n
When creating web server projects or any networking projects, choose the method that is more suitable for your application.<\/p>\n\n\n\n
We hope you’ve found this quick guide useful. We have more tutorials related to Wi-Fi with the Raspberry Pi Pico that you may like:<\/p>\n\n\n\n