══════════════════════════════════════════════════════
  WakeDesk for Linux (amd64 / x86_64) - Release 1.4.20
  Remote Access by CyberTech LLC
  support@cybertechus.com
══════════════════════════════════════════════════════

CONTENTS OF THIS PACKAGE
─────────────────────────
  WakeDesk-1.0.17-amd64.deb        WakeDesk remote access transport + desktop app
  wakedesk-host_1.4.20_all.deb      WakeDesk dashboard / host agent
  install_wakedesk.sh              Guided installer script
  uninstall_wakedesk.sh            Guided uninstaller script
  INSTALL.txt                      This file


REQUIREMENTS
─────────────────────────
  OS:         Debian, Ubuntu, or Kali Linux (any Debian-based distro)
  Arch:       64-bit (amd64 / x86_64)
  Network:    Internet connection required for first install
              (to resolve package dependencies)


QUICK INSTALL (RECOMMENDED)
─────────────────────────────
  1. Copy all files to the same folder on the target machine:

       scp WakeDesk-1.0.17-amd64.deb wakedesk-host_1.4.20_all.deb \
           install_wakedesk.sh uninstall_wakedesk.sh \
           user@<host>:/home/user/

  2. Run the installer:

       chmod +x install_wakedesk.sh
       sudo bash install_wakedesk.sh

  3. Follow the on-screen prompts.

  4. After install, open the WakeDesk dashboard:

       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-1.0.17-amd64.deb ./wakedesk-host_1.4.20_all.deb

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


FIRST-TIME ACTIVATION
──────────────────────
  WakeDesk's remote-access service (wakedesk.service) stays disabled
  until your license is activated. Inbound connections are blocked
  until then.

  1. Open the WakeDesk dashboard (wakedesk-host-gui), or run:
       sudo wakedesk-host activate
  2. Enter your:
       - Customer email
       - Account password
       - License key
  3. Click Activate (or follow the CLI prompts)

  Once activated, wakedesk.service starts automatically. Your WakeDesk
  Device ID and one-time password appear on the 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 (run: wakedesk)
  2. Enter the target's Device ID in the search/connect bar
  3. Enter the one-time password shown on the target'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


UNINSTALL
──────────
  Recommended (removes the packages 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 wakedesk-host
    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 | grep Version

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