Repository navigation
Connecting To WiFi
Join your printer to your home wireless network, so you can control it from a browser and install updates without a USB stick.
- Your Wi-Fi network name and password.
- A printer already running NebulaOS. If it is not, start at Installing NebulaOS.
Nothing moves and nothing heats up during this. It is safe to do at any time, including during a print - though a print will not stop if the network drops, so there is no hurry.
NebulaOS uses 2.4 GHz Wi-Fi. If your router publishes separate names for its 2.4 GHz and 5 GHz networks, pick the 2.4 GHz one. If it uses a single name for both, you do not need to do anything.
-
On the printer's screen, tap Settings (the gear icon).
-
Tap Connections. This page shows your current Wi-Fi network, the printer's address, its name, and the Mainsail, Moonraker and Spoolman addresses.
-
Tap Wi-Fi networks.
-
You now see two groups:
- KNOWN NETWORKS - networks the printer has connected to before and remembers.
- OTHER NETWORKS IN RANGE - everything else it can currently see.
Each row shows signal strength as bars. More bars is better.
-
Find your network in the list and tap its row.
-
Type the password. The small eye button at the end of the field shows what you have typed, which is worth using - a mistyped Wi-Fi password is the single most common reason this step fails.
-
Confirm.
The Wi-Fi networks panel. Saved networks appear first, then everything else in range, each with signal bars.
Some networks are set not to broadcast their name. For those, scroll to the end of the list and tap Other network (hidden)..., then type the network name and password yourself.
Leave the password field empty and confirm.
- Your network moves into KNOWN NETWORKS and shows as connected.
- Going back to Settings → Connections, the Address line now shows an address like
192.168.1.42. Write it down - the next guide needs it.
Tap the connected network's row - the one with a › on it - to open Network Details. It shows signal strength, the security type, and the IP address.
From there you can also:
- Configure Static IP - give the printer a fixed address instead of one your router assigns. Most people do not need this; see below.
- Forget This Network - remove the saved network.
| What happens | What to do |
|---|---|
| The password is rejected | Retype it with the eye button on. Check for a capital letter you missed. |
| Your network is not listed | It may be hidden - use Other network (hidden).... Or it may be 5 GHz only. |
| It connects, then drops | Check the signal bars. One or two bars next to a metal-framed printer is often the cause. |
| No Address appears after connecting | Wait a few seconds and look again; the address comes from your router. |
| Wi-Fi worked before and now does not | Settings → Display → Logs can show the Wi-Fi lines of the system log. |
Network Details → Configure Static IP lets you set the address by hand. Two things to know before you do:
- The setting is global for Wi-Fi, not per network. The panel is titled "Static IP (all Wi-Fi networks)" for that reason.
- NebulaOS checks a new setting before keeping it - for a static address, that the gateway answers; for DHCP, that a lease arrives - and undoes it by itself if it does not work. That check can take a couple of minutes, so do not assume a slow result means failure.
You need four values from your router: IP, Netmask, Gateway and DNS. Each is entered as four boxes, and a number outside 0-255 turns red immediately. Revert to DHCP appears once a static address is set.
Unless you have a reason to need a fixed address, DHCP is the simpler choice.
Opening Mainsail - using the printer from a browser on your computer or phone.