Skip to main content
The Web Terminal lets you connect to a running container through a browser-based shell directly from the AirCloud Console. It is ideal when you need quick operational access without configuring sshd, registering SSH keys, or setting up a local terminal.

​
When to Use the Web Terminal

The Web Terminal is recommended when you want to:
  • Open a shell directly from the Console.
  • Quickly inspect files or running processes inside a container.
  • Run lightweight verification or debugging commands.
  • Avoid configuring SSH access.

​
Availability

​
Custom Containers

For custom containers deployed by users, click Terminal from the endpoint overview page while the container is running. Terminal1

​
AirCloud Templates

Some AirCloud-provided templates include their own built-in terminal interface. Examples include:
  • Notebook environments opened with Open Notebook
  • Web-based IDE environments
Jupyter Notebook Terminal2 In these cases, you can use the terminal already provided within the notebook or IDE without opening the Terminal button on the endpoint page.

​
How the Web Terminal Works

​
1. Open the Terminal

From the endpoint overview page, click Terminal.

​
2. Enable Terminal Access

The first time you open the terminal for an endpoint, an activation dialog appears before the session starts. This enables browser-based terminal access for the endpoint without requiring an sshd configuration. Enable Terminal Access Once terminal access has been enabled, you will not be prompted again unless the endpoint’s access policy is reset.

​
3. Select a Replica

After terminal access has been enabled:
  • If there is one running Replica, the session connects automatically.
  • If there are multiple running Replicas, you are prompted to choose which Replica to connect to.
Select Replica If the selected Replica is restarted or replaced while the session is active, the Web Terminal automatically attempts to reconnect.

​
4. Connect to the Replica

After selecting a Replica, a browser-based terminal session is opened for that Replica. Image 4

​
5. End the Session

You can close the session by:
  • Running exit
  • Pressing Ctrl + D
After the session ends, the terminal window automatically closes after approximately 2 seconds. Image 5

​
If the Web Terminal Does Not Open

Check the following:
  • The endpoint is running.
  • At least one Replica is running.
  • You have permission to access the endpoint.
If no running Replica is available, the terminal cannot be opened until a Replica becomes available.

​
Using aircloud exec from a Local Terminal

If you prefer SSH-free shell access from your local terminal instead of the AirCloud Console, use aircloud exec.

​
Open a Shell

Example:

​
Connect to a Specific Replica

​
Use a Different Shell

​
End the Session

Run exit or press Ctrl + D to close the session.

​
Web Terminal vs. aircloud exec

Both Web Terminal and aircloud exec provide SSH-free shell access to running containers. The difference is where you start the session:
  • Web Terminal starts from the AirCloud Console.
  • aircloud exec starts from your local terminal.