{"id":103157,"date":"2021-04-21T14:56:40","date_gmt":"2021-04-21T14:56:40","guid":{"rendered":"https:\/\/randomnerdtutorials.com\/?p=103157"},"modified":"2024-06-11T09:08:51","modified_gmt":"2024-06-11T09:08:51","slug":"esp32-set-custom-hostname-arduino","status":"publish","type":"post","link":"https:\/\/randomnerdtutorials.com\/esp32-set-custom-hostname-arduino\/","title":{"rendered":"ESP32 Setting a Custom Hostname (Arduino IDE)"},"content":{"rendered":"\n

By default, the hostname of the ESP32 is espressif<\/span>. In this guide, you’ll learn how to set a custom hostname for your board.<\/p>\n\n\n\n

To set a custom hostname for your board, call WiFi.setHostname(YOUR_NEW_HOSTNAME);<\/span> before WiFi.begin();<\/span><\/p>\n\n\n

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

Setting an ESP32 Hostname<\/h2>\n\n\n\n

Usually, the default ESP32 hostname is espressif<\/span> or a similar name.<\/p>\n\n\n

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

There is a method provided by the WiFi.h<\/span> library that allows you to set a custom hostname. <\/p>\n\n\n\n

First, start by defining your new hostname. For example:<\/p>\n\n\n\n

const char* hostname = \"esp32-node-temperature\";<\/code><\/pre>\n\n\n\n
Then, call the WiFi.setHostname()<\/span> function before calling WiFi.begin()<\/span>. You also need to call WiFi.config()<\/span> as shown below:<\/p>\n\n\n\n
WiFi.config(INADDR_NONE, INADDR_NONE, INADDR_NONE, INADDR_NONE);\nWiFi.setHostname(hostname.c_str()); \/\/define hostname<\/code><\/pre>\n\n\n\n
You can copy the complete example below (don’t forget to insert your network credentials):<\/p>\n\n\n
\/*\n  Rui Santos & Sara Santos - Random Nerd Tutorials\n  Complete project details at https:\/\/RandomNerdTutorials.com\/esp32-set-custom-hostname-arduino\/\n  Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files.  \n  The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.\n*\/\n#include <WiFi.h>\n\n\/\/ Replace with your network credentials\nconst char* ssid = "REPLACE_WITH_YOUR_SSID";\nconst char* password = "REPLACE_WITH_YOUR_PASSWORD";\n\/\/ Change the hostname\nconst char* hostname = "esp32-node-temperature";\n\nvoid initWiFi() {\n  WiFi.mode(WIFI_STA);\n  WiFi.config(INADDR_NONE, INADDR_NONE, INADDR_NONE, INADDR_NONE);\n  WiFi.setHostname(hostname);\n\n  WiFi.begin(ssid, password);\n  Serial.print("Connecting to WiFi...");\n  while (WiFi.status() != WL_CONNECTED) {\n    Serial.print('.');\n    delay(1000);\n  }\n  \n  Serial.print("\\nESP32 IP Address: ");\n  Serial.println(WiFi.localIP());\n  Serial.print("ESP32 HostName: ");\n  Serial.println(WiFi.getHostname());\n  Serial.print("RRSI: ");\n  Serial.println(WiFi.RSSI());\n}\n\nvoid setup() {\n  Serial.begin(115200);\n  initWiFi();\n}\n\nvoid loop() {\n  \/\/ put your main code here, to run repeatedly:\n}\n<\/code><\/pre>\n\t
View raw code<\/a><\/p>\n\n\n\n
You can use this previous snippet of code in your projects to set a custom hostname for the ESP32. On the Serial Monitor, you should get the new ESP32 hostname.<\/p>\n\n\n
\n
\"\"<\/a><\/figure><\/div>\n\n\n
Important: <\/strong> you may need to restart your router for the changes to take effect.<\/p>\n\n\n\n
After this, if you go to your router settings, you’ll see the ESP32 with the custom hostname.<\/p>\n\n\n
\n
\"ESP32<\/figure><\/div>\n\n\n
Note:<\/strong> some routers don’t allow you to change the ESP32 hostname using this method. If that’s your case, you’ll need to change it manually on the router’s administration panel.<\/p>\n\n\n\n
Wrapping Up<\/h2>\n\n\n\n
In this tutorial, you’ve learned how to set up a custom hostname for your ESP32. This can be useful to identify the devices connected to your network easily. For example, if you have multiple ESP32 boards connected simultaneously, it will be easier to identify them if they have a custom hostname.<\/p>\n\n\n\n
For more Wi-Fi related functions, we recommend the following tutorials:<\/p>\n\n\n\n