Skip to main content
WARNING! From February 2022, these pages are no longer maintained.
Please see the current Duet3D documentation at

Step Type:

Drag to rearrange

This step is for Duets with WiFi only! Use the command M587 as shown below. Substitute the SSID and WiFi password for those of your network. Enter the exact characters of your network SSID and password, in the correct case. The simple double quote characters (not curly quotes) are needed. Once you press enter, wait for the 'ok' response.

M587 S"your-network-ssid" P"your-network-password"

Note: Any double quotation marks must be sent as straight double quotation marks. Curly double quotations will not work, and generate an error. Also, if you are not using our recommended software to communicate with the Duet and have upper and lower case letters or apostrophe characters in the SSID or password, see the note in the Gcode dictionary entry for M587.

Note: Make sure to connect to a 2.4GHz network; the WiFi module will not connect to 5.0GHz networks.

Send M552 S1 to connect to WiFi. After a moment, the Duet will confirm the connection and the IP address of the Duet controller. The blue LED on the WiFi module will flash as it connects, then should be on constantly once connected. If your router's SSID is hidden, or you want to connect to a specific SSID, send M552 S1 P"my_SSID"

If you get an error, check the network SSID and password you entered with the M587 command. Make sure that the WiFi is in idle mode before sending M587, with M552 S0. Send M587 to get a list of remembered networks, though this does not show the password.

At this point your Duet should be on the wifi network. To connect to the Duet Web Control (DWC) interface, continue to Step 11.

Note: M587 saves the SSID and password to the Duet 2 Wifi, and is persistent. You do not need to run this command every time the board is started. M552 S1 starts the network, and this command does need to be run every time the board starts (so ensure it is in config.g so it runs automatically - editing config.g will be covered later)

Your contributions are licensed under the open source Creative Commons license.