Reading Time:1 minute
0 words

Machine Management ​

Machine Management is the core module of the GM Desktop Client, providing centralized management for server connections. Through an intuitive card view, you can monitor the connection status and resource usage of all servers at a glance, with support for group management, batch import, jump server proxy, and SSH tunneling — making multi-server operations efficient and organized.

Machine Management

Core Features ​

Machine Management covers the complete server connection lifecycle with the following core capabilities:

FeaturePurposeCore Capabilities
Machine OverviewVisual Server MonitoringCard/list dual views, real-time CPU/Memory/Storage monitoring, online status
Group ManagementLogical OrganizationCustom groups, group filtering, group editing
Add MachineConnection ConfigurationSingle add (password/certificate), jump server proxy, connection testing
Batch AddEfficient DeploymentText format batch import, group assignment
TerminalSSH Command LineOne-click connect, multi-tab terminal, AI command generation
GM DesktopVisual Server ManagementDesktop-style app launcher with all management tools
Batch ExecutionMulti-Machine OperationsExecute commands on multiple machines simultaneously

Machine Overview ​

At-a-glance server status monitoring panel. The main interface displays all added servers in a card grid, with each server's connection status and resource usage clearly visible.

  • Machine Card: Each card shows a server's core information:

    • Name & Address: Machine name and connection password (masked) at the top.
    • Connection Status: Top-left dot indicates online status — green for online, gray for offline.
    • Resource Monitoring: Bottom area shows three key metrics in real-time with progress bars for online machines.
  • View Modes: Top toolbar provides two view modes:

    • Card View (grid icon): Grid layout for overview monitoring.
    • List View (list icon): Compact list layout for managing large numbers of machines.
  • Groups & Filtering:

    • Keyword Search: Search box supports fuzzy search by machine name, IP, or notes.
    • Group Tabs: Top tabs display all groups (e.g., "All Groups", "Test"), click to filter by group.
    • Group Editing: Click the edit icon to manage groups — add, rename, or delete groups.
  • Quick Action Bar: Each card provides a row of icon buttons for quick access to various features:

Machine Management

Button (left to right)FunctionDescription
GM DesktopEnter Visual DesktopOpen the GM Desktop management system
TerminalOpen SSH TerminalEnter the command line terminal for this machine
BrowserOpen Local BrowserOpen pages in the local browser, with network traffic routed through this server
TunnelTunnel SettingsConfigure SSH port forwarding rules
MoreMore ActionsPin to top, edit, delete, and other actions

Add Machine ​

Click the "+" button on the left side of the toolbar to open the Add Machine dialog. The dialog contains two tabs: Basic Settings and Advanced Options.

Basic Settings ​

Add Machine - Basic Settings

FieldDescriptionConstraints
Machine NameCustom display name for the machineMax 30 characters
Host AddressServer IP address or domain name—
PortSSH connection portDefault 22
UsernameSSH login usernameDefault root
Auth MethodAuthentication method: "Password" or "Certificate"Toggle
PasswordRequired when auth method is "Password", with visibility toggle—
GroupAssign the machine to a groupDropdown, default "All Groups"
NotesOptional supplementary notesMax 50 characters

Bottom action buttons:

  • Test Connection: Click "Test Connection" to verify SSH connectivity before adding.
  • Cancel / Add: Click "Add" to confirm, or "Cancel" to discard.

Advanced Options ​

Switch to Advanced Options to configure the connection timeout and jump-server proxy.

  • Timeout: Set the SSH connection timeout in seconds, from 10 to 60. Increase it for slow or cross-region connections.

For intranet servers that cannot be accessed directly, you can use a Jump Server for relay connections.

Add Machine - Jump Server

  • Enable Jump Server: Toggle jump-server proxy on or off. When enabled, the target server is accessed through the selected jump server.
  • Select Jump Server: Choose an existing machine from the dropdown as the jump server. Machines are grouped by group name and shown with their host addresses.

Tip

Jump servers are ideal for scenarios where the target server is on an intranet, has no public IP, or security policies restrict direct connections. GM Desktop automatically establishes an SSH tunnel through the jump server for transparent relay, with no manual ProxyJump configuration needed.

Batch Add Machines ​

Click the "Batch Add" button in the toolbar to open the batch import dialog for adding multiple servers at once.

Batch Add Machines

  • Target Group: Select the target group from the top dropdown.
  • Input Format: Enter machines in text format, one per line:
  • Test Connection: Batch test connectivity for all entered machines.
  • Cancel / Next: Click "Next" to proceed, or "Cancel" to discard.
MachineName IPAddress Port Username Password
  • Example: MyServer 192.168.1.1 8080 root password

Note

Batch add does not support certificate authentication — only password authentication. For certificate-based auth, use single machine add to configure each server individually.

Quick Access ​

Each machine card's action bar provides three core entry points for direct access to different management views.

Terminal ​

Click the "Terminal" button to establish an SSH connection and enter the command line terminal. The top tab bar displays the connected machine name and IP, supporting multi-tab multi-terminal simultaneous operation.

Terminal

  • SSH Connection: Automatically connects using the machine's configured credentials, no password re-entry needed.
  • Smart Hints: Top hint bar shows shortcut information, such as ⌘ + I for AI command generation, ⌘ + L to open GMAI.
  • Bottom Toolbar: Quick tool buttons for one-click access to common operations.

Tip

For more terminal features, see: Terminal

GM Desktop ​

Click the "GM Desktop" button to enter the visual desktop management system. This is GM Desktop's core operations interface, integrating all server management tools in a desktop metaphor.

GM Desktop

The desktop arranges all available management applications in an icon grid, with the bottom taskbar showing the current time and machine IP address.

Tip

For more about GM Desktop, see: GM Desktop

GM Desktop Service ​

The client bottom provides a GM Desktop Service status bar showing local service status:

  • Local Service: Toggle to start/stop the local GM Desktop service. When enabled, the client can monitor resource status (CPU, Memory, Storage) for all connected machines in real-time.