1
Step 1Open the server Apps tab
Select the tutorial-vps VPS, open the Apps tab, and start a new app deployment. Keep sensitive server details hidden before capturing or sharing screenshots.
Back to all templates
UpSnap
Infrastructure256MB+ RAM
Wake-on-LAN web app to power on, monitor, and shut down devices on your network
infrastructuremonitoringupsnapopen-sourceself-hosteddocker
Deploy UpSnap in 3 Steps
1
Connect Your VPS
Add your server credentials to Server Compass
2
Select UpSnap
Choose from our template library
3
Deploy & Configure
Fill in settings and click Deploy
No Docker knowledge required
Step-by-step deployment guide
Deploy UpSnap on a VPS with Server Compass
Use the UpSnap template in Server Compass to deploy a self-hosted Wake-on-LAN dashboard on your VPS, configure its scan interval and LAN range, then verify the web UI in a browser.
About 10 minutesBrowser verified
2
Step 2Choose an app template
Click New App and choose the template deployment path so Server Compass can load the built-in catalog.
3
Step 3Search for UpSnap
Use the template picker search to find UpSnap in the Server Compass template catalog.
4
Step 4Select the UpSnap template
Choose the UpSnap template. Server Compass fills the UpSnap service, public web port, scan interval, LAN scan range, and the network capabilities UpSnap needs for ping and Wake-on-LAN packets.
5
Step 5Review the UpSnap settings
Confirm the app name, web port, scan interval, and LAN range. In this run, the app was named upsnap-demo, used host port 4253, and kept the demo scan range at 192.168.1.0/24.
6
Step 6Deploy UpSnap
Review the generated compose settings, confirm the UpSnap web port is available, and click Deploy.
7
Step 7Watch the deployment progress
Keep the deployment modal open while Server Compass uploads the compose file, pulls the UpSnap image, starts the container, and verifies the stack.
8
Step 8Confirm UpSnap is running
After deployment finishes, return to the Apps tab and confirm the UpSnap app is marked Running with its application URL available.
9
Step 9Open UpSnap in the browser
Open the application URL in a browser. The UpSnap sign-in or device dashboard confirms the Wake-on-LAN web app is reachable.
After UpSnap Opens
- Register the first user and treat that account as the administrator.
- Change UPSNAP_SCAN_RANGE to the real LAN CIDR where the devices live, then redeploy.
- If Wake-on-LAN packets do not reach devices from the Docker bridge network, switch the service to host networking and remove the explicit port mapping.
- Add one non-critical device first with its MAC address and IP, then test status checks before using wake or shutdown actions.
- Disable open signups after intended users have accounts, and put the UI behind HTTPS or an access-controlled reverse proxy.
- Back up the upsnap_data PocketBase volume because it stores users, device records, and shutdown connection details.
- Keep the UpSnap image updated for dependency and security fixes.
Verified Result
The UpSnap web interface loaded successfully from the deployed container. The tutorial verifies the web UI only; real device wake tests depend on the Docker host being on the same LAN as the target devices.
UpSnap deployment questions
What does the UpSnap template deploy?
It deploys UpSnap as a single-container Wake-on-LAN and LAN device monitoring web app with a persistent PocketBase data volume.
Which port did the tutorial use?
The tutorial used host port 4253, which maps to the UpSnap web UI inside the container on port 8090.
Does UpSnap need setup after deployment?
Yes. Register the first user, set the scan range to the real LAN, then add devices with their IP addresses and MAC addresses.
Can a VPS wake devices on my home LAN?
Usually no. Wake-on-LAN magic packets normally stay inside one broadcast domain, so a cloud VPS can load the UpSnap UI but cannot wake devices on a private home LAN unless networking is bridged or tunneled appropriately.
Should this become a blog post?
No. The deployment guide should live on the UpSnap template detail page and be linked from the reusable template deployment docs page.
After Deployment
After deploying UpSnap with Server Compass, complete these steps to finish setup
1
Open http://YOUR_SERVER_IP:{{PORT}} and register the first user (becomes admin)
2
Verify the Docker host is on the same LAN as the devices you want to wake; switch to `network_mode: host` in the compose if WoL packets do not reach targets
3
Add devices under Devices -> add (set MAC address, IP, and optional SSH shutdown command)
4
Confirm `UPSNAP_SCAN_RANGE` matches your LAN; adjust and redeploy if not
5
Test by powering off a device and clicking the wake button - it should boot within seconds
Need help? Check out our documentation for detailed guides.
UpSnap FAQ
Common questions about self-hosting UpSnap
How do I deploy UpSnap with Server Compass?
Simply download Server Compass, connect to your VPS, and select UpSnap from the templates list. Fill in the required configuration and click Deploy. The entire process takes under 3 minutes.
What are the system requirements for UpSnap?
UpSnap requires a minimum of 256MB RAM. We recommend a VPS with at least 1024MB RAM for optimal performance. Any modern Linux server with Docker support will work.
Can I migrate my existing UpSnap data?
Yes! Server Compass provides volume mapping that allows you to import existing data. You can also use standard UpSnap backup and restore procedures.
How do I update UpSnap to the latest version?
Server Compass makes updates easy. Simply click the Update button in your deployment dashboard, and the latest UpSnap image will be pulled and deployed with zero downtime.
Is UpSnap free to self-host?
UpSnap is open-source software. You only pay for your VPS hosting (typically $5-20/month) and optionally Server Compass ($29 one-time). No subscription fees or per-seat pricing.
Ready to Self-Host UpSnap?
Download Server Compass and deploy UpSnap to your VPS in under 3 minutes. No Docker expertise required.
Download Server Compass