FOR POCKET SERVER OWNERS

Get your pocket server running

Your board comes with the firmware already installed — just power it on and follow the four steps below.

Building your own instead? Flash it here first.

01

Join its Wi‑Fi network

Power it on, then connect to the network with the name "pocket-server-xxxx" with default password password123. You can change these once you’re in — or switch it to join your own Wi‑Fi instead from the admin page's Network tab.

02

Open the admin page

It may pop up automatically. If not, go to http://pocket.local/ — a server nobody has claimed yet shows its setup page there, and won't do anything else until you've done step 3.

03

Claim it with a password

This is the whole of setup. It's what makes the server yours: from then on only someone with that password can change its Wi‑Fi, replace your homepage, or wipe it. There's no account and no email — the password is stored on the board and never leaves it, which also means nobody can send it back to you if you forget it. Write it down. (It isn't the Wi‑Fi password from step 1, and it doesn't make what you put on the server private — anyone on the network can still read that.)

04

Upload your first app

Upload any .html file from the admin page, or set one as your homepage. Not sure where to start? Grab one of the ready-to-go examples below and brew it in seconds, or let AI build something for you.

Example apps

Download one of these and upload it from the admin page to see your server in action.

Pirate Box Pocket

Browse folders and share files, with live storage monitoring built in. Named after — but distinct from — the original PirateBox project.

Collaborative whiteboard

An infinite pan-and-zoom whiteboard everyone on your network can draw on together, live.

Pocket chat

A one-room chat over the WebSocket endpoint — no internet, no accounts, just whoever's connected.

See all example apps → Build your own — developer guide →

Troubleshooting

I can’t find the Wi‑Fi network

Give it a minute after power-on, and make sure you’re looking for a network prefixed "pocket-server" in your Wi‑Fi list.

I lost the admin page

Navigate straight to http://pocket.local/admin any time — it doesn’t depend on what homepage is currently set. More ways in, and what to do if you’ve lost the password →

I want to start over

The DELETE /storage endpoint (or the admin page’s clear-storage option) wipes every file on the device.

My board won’t connect to my home Wi‑Fi

By default it doesn’t need to — it broadcasts its own network, and everyone just joins that instead of your router. If you switched it to join your home Wi‑Fi from the admin page's Network tab and it can’t find or connect to that network at startup, it automatically falls back to broadcasting its own network again.

Still stuck? Ask in the Discord!