Skip to main content

Quick Start

This guide walks you through connecting to your first remote machine after installing Gatwy.

1. Create Your Admin Account​

On first launch, open https://<YOUR_IP>:7443 and follow the setup wizard to create an admin account.

2. Add a Connection​

  1. Click New Connection in the sidebar (or right-click a folder → Add Connection)
  2. Choose a protocol: RDP, SSH, VNC, Telnet, SMB, SFTP, or FTP
  3. Enter the target host and port
  4. Provide credentials
  5. Click Save, then double-click the connection to open it

3. Start a Session​

Sessions open as browser tabs — no plugins, Java, or client software required.

RDP Sessions​

RDP runs via Gatwy's WebAssembly engine — no Guacamole, no bitmap relay:

  • Clipboard sharing
  • File transfer
  • Dynamic resolution scaling
  • Session recording (WebM video) with click ripple indicators

SSH / Telnet Sessions​

Full xterm.js terminal with:

  • Unlimited width
  • Copy/paste support
  • Port-forward tunnels
  • Session recording (asciinema) and command-level audit log
  • Passwords automatically redacted from audit trails

VNC Sessions​

Graphical remote desktop via noVNC with adjustable quality.

SMB / SFTP / FTP​

Full-featured file browser — browse, upload, download, rename, copy, move, delete, create folders, change permissions. All file operations are logged in a searchable audit timeline.

4. Organize Your Connections​

  • Folders — nest connections arbitrarily deep; drag & drop to reorder
  • Tags — label connections (e.g. prod, linux) and filter by tag
  • Search — instant search-as-you-type across all connection names and hosts
  • Right-click — full CRUD from the sidebar context menu

5. Split Panes & Tabs​

  • Split panes — view multiple sessions side by side in one tab
  • Tab drag & drop — drag a tab onto another to create a split view
  • Session persistence — sessions survive a page refresh without reconnecting

Next Steps​