══════════════════════════════════════════════════════
  WakeDesk for Raspberry Pi 4 / Pi 5
  Remote Access by CyberTech LLC
  support@cybertechus.com
══════════════════════════════════════════════════════

CONTENTS OF THIS PACKAGE
─────────────────────────
  WakeDesk-RPi-X.Y.Z-arm64.deb   Main install package
  install_wakedesk.sh                   Guided installer script
  uninstall_wakedesk.sh                 Guided uninstaller script
  INSTALL.txt                           This file


REQUIREMENTS
─────────────────────────
  Hardware:   Raspberry Pi 4 or Raspberry Pi 5
  OS:         Raspberry Pi OS Bookworm (64-bit) — recommended
              Ubuntu 22.04 / 24.04 ARM64 (also supported)
  Arch:       64-bit (arm64 / aarch64) — 32-bit is NOT supported
  Network:    Internet connection required for first install
              (to resolve package dependencies)
  Display:    HDMI connected, or headless with a virtual display
              configured (the installer handles this automatically)


QUICK INSTALL (RECOMMENDED)
─────────────────────────────
  1. Copy both files to the Pi (same folder):

       scp WakeDesk-RPi-*-arm64.deb install_wakedesk.sh \
           wakeos@<pi-ip>:/home/wakeos/

  2. SSH into the Pi and run the installer:

       chmod +x install_wakedesk.sh
       sudo bash install_wakedesk.sh

  3. Follow the on-screen prompts.
     The installer will ask to reboot at the end — say Yes.

  4. After reboot, open the WakeDesk dashboard:

       From the desktop:  Internet → WakeDesk
       From terminal:     wakedesk-host-gui


MANUAL INSTALL (ALTERNATIVE)
──────────────────────────────
  If you prefer to install without the guided script:

       sudo apt-get update
       sudo apt-get install -y ./WakeDesk-RPi-X.Y.Z-arm64.deb
       sudo wakedesk-host fix-display
       sudo reboot

  IMPORTANT: Use  apt-get install ./filename.deb  (not dpkg -i).
  The apt method resolves all dependencies automatically.


FIRST-TIME ACTIVATION
──────────────────────
  1. Open the WakeDesk dashboard (wakedesk-host-gui)
  2. Go to Settings → License
  3. Enter your:
       - Customer email
       - Account password
       - License key
  4. Click Activate

  Your WakeDesk Device ID and one-time password appear on the
  main dashboard. Share the Device ID with whoever needs to
  connect remotely.


CONNECTING REMOTELY
────────────────────
  From WakeDesk on another computer (Kali, Ubuntu, Windows, etc.):

  1. Open WakeDesk
  2. Enter the Pi's Device ID in the search/connect bar
  3. Enter the one-time password shown on the Pi's dashboard
     (or the permanent password if one has been set)
  4. Click Connect


PASSWORDS
──────────────────────────────
  One-time password (OTP):
    • Displayed on the main dashboard
    • Rotates each time you click the refresh icon
    • Safe to share for a single session

  Permanent password (optional):
    • Set in the dashboard under Settings
    • Not displayed — write it down and store it safely
    • Works alongside the OTP (both passwords accepted simultaneously)
    • Use to reconnect if the OTP has rotated


SERVICE MANAGEMENT
───────────────────
  Check status:
    sudo systemctl status wakedesk wakedesk-host --no-pager

  Restart services:
    sudo systemctl restart wakedesk wakedesk-host

  Stop services:
    sudo systemctl stop wakedesk wakedesk-host

  View host agent status:
    sudo wakedesk-host status

  Diagnose (shows IDs, connection state, environment):
    sudo wakedesk-host diagnose


HEADLESS / NO MONITOR SETUP
─────────────────────────────
  WakeDesk works without a physical monitor attached.
  The installer automatically:
    • Adds  video=HDMI-A-1:1920x1080@60D  to /boot/firmware/cmdline.txt
    • Configures HDMI hotplug and framebuffer size in config.txt
    • Sets up LightDM autologin for the wakeos user

  If the Pi is used headlessly and the desktop doesn't appear
  after a reboot, run:

    sudo wakedesk-host configure-headless


WAYLAND / SCREEN CAPTURE
──────────────────────────
  Raspberry Pi OS Bookworm on Pi 5 defaults to the Wayfire
  Wayland compositor. WakeDesk requires X11 for screen capture.

  The installer switches the session to X11 automatically
  (via raspi-config do_wayland W1). A reboot is required.

  If you see "Wayland screen capture failed" after installing:

    sudo wakedesk-host fix-display
    sudo reboot


BACKUP AND RESTORE
───────────────────
  Create a backup (saves activation, config, and ID):
    sudo wakedesk-host backup

  Backups are stored in:  /home/wakeos/wakedesk-backups/

  Restore from backup:
    sudo wakedesk-host restore /home/wakeos/wakedesk-backups/<file>.tar.gz


UNINSTALL
──────────
  Recommended (removes the package but keeps this device's Device ID and
  license activation, so reinstalling reconnects to the same device):

    sudo bash uninstall_wakedesk.sh

  To also delete saved backups:

    sudo bash uninstall_wakedesk.sh --all

  Permanently decommissioning this device? Also wipe its Device ID and
  license activation (it will need to be re-registered if reinstalled):

    sudo bash uninstall_wakedesk.sh --purge-identity

  Manual alternative:

    sudo apt-get remove --purge wakedesk-rpi
    sudo apt-get autoremove


SUPPORT
────────
  Email:    support@cybertechus.com
  Subject:  Include your Device ID and OS version

  Useful info for support requests:
    sudo wakedesk-host diagnose
    sudo wakedesk-host status
    dpkg -s wakedesk-rpi | grep Version

══════════════════════════════════════════════════════
  CyberTech LLC — WakeDesk Remote Access
══════════════════════════════════════════════════════
