Web UI Usage
articwake includes a responsive, mobile-friendly web interface for managing your homelab server.
Accessing the UI
Section titled “Accessing the UI”Open your browser and navigate to:
- Local network:
http://<pi-ip> - Tailscale:
http://<tailscale-hostname>
Authentication
Section titled “Authentication”- Enter your PIN in the login form
- Click “Login”
- You’ll receive a session token valid for 15 minutes
Session Expiry
Section titled “Session Expiry”Sessions expire after 15 minutes of inactivity. You’ll be prompted to log in again.
Rate Limiting
Section titled “Rate Limiting”To prevent brute-force attacks, login attempts are limited to 10 per minute per IP address. If rate limited, wait 60 seconds before trying again.
Status Display
Section titled “Status Display”After logging in, the status panel shows:
| Status | Meaning |
|---|---|
| Homelab IP | Your configured server IP |
| Reachable | Can ping the server |
| initrd SSH | Dropbear port is open (server waiting for unlock) |
| System SSH | Main SSH port open (server fully booted) |
Status Indicators
Section titled “Status Indicators”- Server off: Not reachable, no SSH ports open
- Waiting for unlock: Reachable, initrd SSH open, system SSH closed
- Fully booted: Reachable, system SSH open
Actions
Section titled “Actions”Sends a Wake-on-LAN magic packet to power on your server.
- Click “Wake”
- Wait for the server to power on (usually 10-30 seconds)
- Click “Refresh Status” to check if it’s reachable
Unlock
Section titled “Unlock”Sends your LUKS passphrase to the server’s dropbear SSH.
- Enter your LUKS passphrase
- Click “Unlock”
- Wait for the system to boot (usually 30-60 seconds)
- Click “Refresh Status” to verify
Workflow
Section titled “Workflow”Typical usage:
- Open the web UI from your phone or laptop
- Check status - is the server reachable?
- Wake - if server is off, send WOL packet
- Wait - for the server to boot to initrd (~10-30s)
- Refresh - check that initrd SSH is open
- Unlock - enter LUKS passphrase
- Wait - for full boot (~30-60s)
- Refresh - verify system SSH is open
- Done - your server is now accessible
Mobile Usage
Section titled “Mobile Usage”The web UI is designed to work well on mobile devices:
- Responsive layout adapts to screen size
- Large touch targets for buttons
- Simple, focused interface
Troubleshooting
Section titled “Troubleshooting”Can’t log in
Section titled “Can’t log in”- Verify your PIN is correct
- Check you haven’t been rate limited (10 attempts/min)
- Verify the service is running:
ssh root@<pi-ip> "rc-service articwake status"
Wake not working
Section titled “Wake not working”- Verify MAC address in configuration
- Check WOL is enabled in server BIOS
- Ensure Pi and server are on the same network segment (or broadcast address is correct)
Unlock not working
Section titled “Unlock not working”- Verify the initrd SSH port is shown as open
- Check your LUKS passphrase is correct
- Verify SSH key is authorized in server’s initrd
- Check
/var/log/articwake.logfor errors