Using the TUI

Navigate the terminal interface

The deeploy TUI (Terminal User Interface) is built for keyboard-driven workflows.

Layout

The TUI uses a panel-based layout with three sections in the left sidebar, stacked vertically:

  • Projects
  • Pods
  • Settings

Navigate between panels and content with keyboard-first controls.

Key Action
Tab Next sidebar panel
Shift+Tab Previous sidebar panel
Enter / l / → Open / drill in
Esc / h / ← Back / drill out
j / k or ↑ / ↓ Move selection
? Open keyboard help
Ctrl+B Back to profile selector

Common Actions

When the sidebar is focused:

  • n creates new items (project, pod, token)
  • e edits selected project/pod
  • d deletes selected project/pod
  • D deploys selected pod
  • S stops selected pod
  • R restarts selected pod

Pod Panel

Inside a pod, use:

  • 1 / 2 / 3 / 4 to switch Overview/Logs/Domains/Vars
  • [ / ] to switch tab
  • c to copy logs (Logs tab)
  • n, g, o, e, d for domain actions (Domains tab)
  • e to edit vars, Ctrl+S to save, Esc to cancel (Vars tab)

For detailed vars behavior and best practices, see Pod Environment Variables.

Themes

Open themes from the Settings panel:

  1. Tab to the sidebar Settings panel
  2. Select Themes
  3. Press Enter

Then pick a theme in the modal.

Available themes include:

  • Catppuccin (Mocha, Latte, Frappé, Macchiato)
  • Gruvbox (Dark, Light)
  • Nord
  • Dracula
  • Tokyo Night
  • One Dark
  • Rose Pine
  • Kanagawa
  • Solarized
  • And more…

Theme preference is saved locally.

Profiles (Multi-VPS)

deeploy supports multiple server profiles in one TUI.

With profiles you can:

  • Add multiple VPS servers
  • Switch the active server quickly
  • Store auth token and server settings per profile
  • Delete profiles you no longer need

Use the profile selector and profile forms to manage this flow.

Offline Mode

If the connection to your server is lost, the TUI enters offline mode. It will automatically reconnect when the server is available again.

← DeployingDomains →
© 2026 Axel Adrian