004 / Documentation20 articles

Features &
Usage Guide.

Welcome to the Ultron SSH knowledge base. Browse our core features and step-by-step guides to supercharge your remote infrastructure workflows.

01

Core Features

Terminal & Session Management

Ultron is built from the ground up for developer speed. Key terminal capabilities include:

  • Native Performance: Fully optimized native builds for macOS (Intel & Apple Silicon), Windows, and Linux. Built with GPU-accelerated rendering and high-refresh rates to eliminate cursor lag.
  • Multiple Tabs & Splitting: Customize layouts with multi-split window configurations (horizontal and vertical panes). Broadcast commands to multiple tabs/splits simultaneously to update clusters at once.
  • Local Shell Integration: Launch local terminal tabs alongside remote sessions, displaying real-time local Docker status and system metrics.

Docker Socket Dashboard & Deployer

Monitor, build, and deploy containers without typing complex docker CLI commands:

  • Live Container Dashboard: Instantly view active containers, CPU/Memory resource charts, and live console logs right in the app sidebar.
  • App Deployer: Write or paste a docker-compose.yml file, specify the target directory, and boot your container stack instantly.
  • Dockerfile Builder: Create custom build triggers, map ports, define environment variables, and monitor compilation steps in real-time.

VMware & XCP-ng Control

Consolidate your hypervisors and SSH sessions. Connect to VMware ESXi and XCP-ng hypervisors natively:

  • API Integration: Log in directly to ESXi or XCP-ng servers via API endpoints. No more complex vSphere or XenOrchestra browser tabs.
  • VM Monitoring: View all guest virtual machines, OS types, and CPU/Memory allocations directly in your sidebar.
  • Power Management: Trigger VM actions (Start, Shutdown, Reboot, and Reset) natively.

AI Assistant & Auto-Mode Execution

Fix broken configurations faster with an integrated assistant that reads active terminal context:

  • Context-Aware AI: Powered by Gemini 3.1 Pro, the assistant reads your active terminal scrollback to determine exactly why a command failed.
  • Auto-Mode Bridge: Safely drafts, refines, and executes diagnostic or correction commands directly on the connected host after your explicit approval.

Universal SFTP Browser & Editor Bridge

Seamless file transfers and remote editing integrations:

  • Visual Explorer: Drag-and-drop file imports, quick renames, directory traversal, and permission management.
  • Editor Sync: Click "Edit Externally" to open remote files in your local IDE (VS Code, Cursor, Vim, etc.). Ultron automatically uploads updates in the background whenever you save.

System Metrics & Monitoring

Get an instant look at host health without running top/htop:

  • Live Monitor Panels: Displays real-time charts for CPU, RAM, swap space, disk metrics, and system load averages inside your active connection layouts.

Security & Sync Profiles

A Zero-Trust security layout that keeps your credentials secure:

  • Local AES-256-GCM Encryption: Configurations and SSH keys are encrypted locally using a master password stretched via scrypt. We never see your raw credentials.
  • End-to-End Cloud Sync (Pro): Sync host profiles, configurations, and custom script snippet libraries securely across multiple devices with zero-knowledge keys.

Native Network Storage Mounting

Mount and browse your file servers natively from the sidebar:

  • Cross-Platform Mounting: Supports native mounting via AppleScript (macOS), net use drive letters mapping (Windows), and Userspace GNOME gio mount (Linux).
  • SFTP Browser Integration: Once mounted, browse folders in a tabbed panel, drag-and-drop uploads/downloads, or edit code externally using local IDEs.
02

Step-by-Step Usage Instructions

Initial Setup

  1. Download the installer matching your OS (macOS DMG, Windows EXE, or Linux AppImage).
  2. Launch the application and create a strong Master Password. This password generates the key used for local AES-256-GCM encryption. Do not lose it—it is stored nowhere for your security.

Connecting to a Host

  1. Click the Add Host (+) button in the Sidebar.
  2. Enter the connection parameters:
    • Label: E.g., Production API Server
    • Hostname/IP: The server address.
    • Auth Method: Password or SSH Private Key file selection.
  3. Click Save & Connect to open the tabbed terminal.

Deploying an Application

Deploy application stacks using the built-in Docker editor:

  1. Open your server tab and click the **Docker** header at the top.
  2. Click **Deploy App** and select either **Docker Compose** or **Dockerfile**.
  3. Paste your code, specify a project name, choose the target directory, and click **Deploy**.
  4. A console logs window will overlay showing compile / pull progress in real-time.

Installing Docker on a Server

  1. Navigate to the **Docker** tab on a newly connected server.
  2. If the engine is missing, a warning banner will appear saying *"Docker is not installed on this server"*.
  3. Click **Install Docker**. Ultron will automatically spin up the installer script and stream console updates until finished.

Managing Virtual Machines

  1. In the **Add Host** dialog, toggle **Hypervisor Integration** and choose **VMware ESXi** or **XCP-ng**.
  2. Input the API endpoint and login credentials.
  3. Double-click the bookmark to load the VM Control Panel. Hover over guest machines to access power state triggers (Start, Shutdown, Reboot, Reset).

Asking the AI Assistant

  1. When a terminal run fails, click the **AI Assistant** sidebar panel on the right.
  2. Click **Explain Error**. The assistant reads terminal outputs to identify the bug.
  3. Review the correction plan and click **Run Suggestion** to pipe the script to the shell.

Browsing Remote Files (SFTP)

  1. In the host terminal tab, click the **SFTP** icon in the toolbar.
  2. Browse files, click action icons, and choose **Edit Externally**.
  3. Edit the code locally. Save changes in your editor, and watch Ultron push updates in real-time.

Mounting Network Storage

  1. Click the **Network Storage** icon in the app sidebar.
  2. Click **Add Storage** and select **SMB / CIFS (Windows)** or S3/FTP.
  3. Input server host, username, and password credentials and click **Save**.
  4. Click the **Mount** button. On Windows, this automatically maps to a local drive letter. On macOS/Linux, it mounts under your OS volumes directory, showing a `Mounted` status with a browse folder button.
03

Troubleshooting & Diagnostics

Email Verification Issues

If you have trouble logging in or resetting password:

  • Email Unconfirmed Lockout: Ultron enforces strict email verification locks on both the website and desktop clients. If your account is unconfirmed, you will be blocked from logging in or requesting password recoveries.
  • Resending Link: To resend verification tokens, go to the Sign In page, enter your signup details, and click Submit. The system will automatically detect your unverified profile and trigger a new verification link.

2FA App Spelling Typo

Spelling issues in the Authenticator app:

  • Authenticator Label Typo: If your authenticator app saved the account name misspelled as untronssh.com or untrolssh.com, this is caused by an old enrollment URI spelling issue.
  • Resolution: Upgraded profiles automatically sanitize OTP enrollment URIs. Scan the QR setup code again in the MFA settings page to overwrite and display the correct ultronssh.com label.

Network Storage Mount Failures

If mounting an SMB share fails with an error alert:

  • Pro Tier Check: Network storage mounting requires an active Pro subscription tier.
  • Windows Path Format: Verify the host follows backslash formatting: \\192.168.1.100\ShareName instead of slash formatting.
  • Linux Dependencies: Linux requires the virtual filesystems utilities package (gio-mount or GNOME libraries) to mount remote folders in user space without root sudo privileges.

Startup Script Timing Handshake

Startup snippets executing too early or failing:

  • Upgrade to v1.4.32: Older desktop versions executed script snippets blindly 1.5 seconds after connection triggers. Version 1.4.32 uses active event listeners that hook into the SSH connection ready signal, executing startup scripts exactly when the shell environment is initialized.

Frequently Asked Questions