Suwu Docs
Everything you need to get the most out of Suwu — from keyboard shortcuts to CLI commands.
Overview
Get Started
Install Suwu and get your first terminal running in under a minute.
Upgrading
Update Suwu to the latest version and manage configuration.
Security & Data
Where Suwu stores data, security considerations, and intranet usage guidance.
Core
Tiling Window Manager
Split, focus, move, and swap tiles with keyboard or mouse. Your layout survives refreshes and disconnects.
Terminals
Full-featured shells with selection, scrollback, and notifications — built for humans and agent orchestrators.
Security & Access
Password auth, per-run tokens, and one-command HTTPS — reachable, but only by you.
Public Access
Put Suwu behind a reverse proxy, a wildcard host check, and zero-trust identity.
Apps
File Browser
Navigate directories, download files, and open the file viewer — right in a tile.
File Viewer
View files with syntax highlighting, auto-refresh, and PDF rendering.
Port Forwarding
TCP and UDP port forwarding from the browser — no extra tooling needed.
Dropbox
Upload and download files between your local machine and the remote server.
DB Browser
Connect to SQLite, MySQL, or PostgreSQL, run SQL, and explore results in a tile.
Folder Sync
Mirror a server folder into a folder on your own computer, re-checked every few seconds.
Developer Tools
Git Graph
Visualize branch history, commits, and merges in an interactive graph.
Diff Viewer
Side-by-side and inline diffs with syntax highlighting.
REST Helper
Build, send, and read HTTP requests — from the server, with history and a cookie jar.
Extend
Extensions
Add your own app tile with a sandboxed JavaScript extension — APIs, static assets, and all.
gqjs Script Runner
suwu gq runs one JavaScript file in a request-scoped QuickJS sandbox.