ESP32 Bit Pirate home
  • Wi-Fi
  • Beginner
  • 5 min
  • Web CLI

Recipe · Beginner · Wi-Fi

How to use Web CLI hotspot mode

Use Wi-Fi hotspot mode to access the browser CLI without an existing router or saved credentials.

Web Serial terminal connected to hardware.
Start with read-only checks, then move to write, replay or automation only when the setup is understood.
Step 1

Workflow

  1. Select WiFi Hotspot from the device terminal selection at boot.
  2. Connect your phone or computer to the network created by the board.
  3. Open the Web CLI URL shown by the device.
  4. Keep the serial CLI available for long output or recovery.

Result

What it means

The browser can reach the firmware terminal without an existing router, which is useful for demos, field checks and quick setup from a phone.

Troubleshooting

  • If the hotspot is not visible, reboot and watch the terminal selection screen.
  • If the page does not load, confirm the client joined the Bit Pirate network and not another saved network.
  • Prefer Serial CLI for long captures or high-volume output.
  • Do not reset Wi-Fi from the Web CLI while using the hotspot session.

Next steps

  • Save the output in your project notes.
  • Compare the result with the full wiki page for mode-specific details.
  • Create a shorter alias if you repeat this workflow often.

Web CLI hotspot FAQ

What is Web CLI hotspot mode for?

It lets you reach the Bit Pirate browser interface over Wi-Fi when you want a terminal without keeping a USB serial session open.

Why do I still need Serial CLI sometimes?

Initial setup, credential recovery and high-output commands are more reliable over USB Serial. The wiki specifically recommends Serial CLI for workflows that may drop data in Web terminal.

Which tasks are best suited to the Web CLI hotspot?

The hotspot is best for short interactive checks, field access and quick commands where losing the browser session would not interrupt a long capture or critical write.

Go deeper