The rescue feature provides browser-based Virtual Network Computing (VNC) access to your Simple Application Server. Use it to diagnose and fix issues that prevent Workbench or third-party tools such as PuTTY, Xshell, or SecureCRT from connecting.
| Limitation | Detail |
|---|---|
| File transfer | Not supported over rescue connections |
| Low-bandwidth networks | Latency, stuttering, or image quality degradation may occur |
| Session timeout | About 300 seconds of inactivity; the connection closes automatically |
For routine access, connect through Workbench or a third-party client. For more information, see Connect to a Linux server and Connect to a Windows server.
When to use the rescue feature
Troubleshooting -- Connect through VNC when high vCPU utilization or SSH configuration changes block Workbench and third-party tool access.
GUI logon -- After building a GUI on a server running an operating system such as Ubuntu, connect through VNC to use the graphical desktop.
Prerequisites
Before you begin, ensure that you have:
Configured a password for the server. For more information, see Set or reset server passwords
Verified that the server is in the Running state
Start a rescue connection
Go to the Servers page in the Simple Application Server console.
In the server card, click Remote Connection.

In the Rescue Logon section of the Remote Connection dialog box, click Log on Now. The rescue connection page opens. If the page does not appear, check whether your browser blocked the pop-up.

Complete the logon for your operating system.
Log on to a Linux server
Enter a username, such as root, and press
Enter.Enter the logon password and press
Enter.NotePassword characters are hidden during entry to prevent leakage. Verify that you enter the correct password.
The following output indicates a successful logon.

(Optional) To paste long text, such as a file download URL, from your on-premises device to the server, click copy command in the upper-right corner of the rescue connection page and paste the text in the dialog box that appears.
(Optional) Switch VNC terminals by pressing CTRL+ALT+F1 through CTRL+ALT+F10. Each terminal can run different programs. The default terminal is CTRL+ALT+F1. You can also switch terminals from the menu icon in the upper-left corner of the rescue connection page. For example, choose .

Log on to a Windows server
(Conditionally required) If the desktop is locked, choose in the upper-left corner of the page.

On the Windows administrator logon page, enter the logon password and press
Enter.
FAQ
Related topics
Troubleshoot connection issues:
Build an Ubuntu GUI: