Skip to content

Launch an Ubuntu Virtual Lab

Beginner 5 minutes Auto-generated screenshots

Overview

In this tutorial, you'll launch an Ubuntu Virtual Lab on the RosettaHub Supercloud platform. Virtual Labs provide a full desktop environment accessible directly in your browser -- no SSH client, RDP client, or VNC software required. The desktop is streamed to your browser using VNC/Guacamole technology, giving you a complete Ubuntu graphical interface from any device with a modern web browser.

Virtual Lab vs. Workspace

Feature Virtual Lab Workspace
Access Method Browser-based desktop (VNC/Guacamole) SSH (Linux) or RDP (Windows) client
Client Software Required None -- just a web browser SSH client, PuTTY, or RDP client
Desktop Environment Full graphical desktop in browser Command-line (SSH) or desktop (RDP)
Best For Quick access from any device, no setup Power users who prefer native clients
Customization Clone, customize, snapshot (same workflow) Clone, customize, snapshot (same workflow)

Prerequisites

  • [ ] RosettaHub account with active subscription
  • [ ] At least one cloud account connected (see Cloud Keys)
  • [ ] Access to the Ubuntu Virtual Lab formation under Virtual Labs
  • [ ] A modern web browser (Chrome, Firefox, Edge, or Safari)

Steps

Step 1: Select the Ubuntu Virtual Lab

From the RosettaHub dashboard, select the Workspaces and Labs perspective. In the Virtual Labs section of the formations panel, click on Ubuntu Virtual Lab.

Step 2: Launch the Virtual Lab

The launch confirmation panel appears. Click Yes to deploy the virtual lab.

Your session appears under the Sessions panel. Wait for the status indicator to show a green tick, indicating the virtual lab is ready.

Note

Virtual Labs typically provision within 1-3 minutes depending on the cloud provider and region.

Step 3: Connect to Your Desktop

Click on the running session. A new browser tab opens, and you are connected to a full Ubuntu desktop running in the cloud.

You now have a complete graphical Linux environment with:

  • File manager
  • Terminal emulator
  • Text editors
  • Web browser
  • System settings and tools

All interaction happens through your browser -- mouse, keyboard, clipboard, and file operations work as expected.

Tip

For the best experience, use your browser's full-screen mode (typically F11) to maximize the desktop area.

Working with Your Virtual Lab

The Ubuntu desktop works like any standard Ubuntu installation. Use the application menu, taskbar, and file manager to navigate. Right-click the desktop for additional options.

Using the Terminal

Open a terminal from the application menu or taskbar to run commands, install software, and manage the system.

sudo apt update
sudo apt install <package-name> -y

Clipboard Integration

Copy and paste between your local machine and the virtual lab desktop is supported through the browser. Use the standard keyboard shortcuts (Ctrl+C / Ctrl+V) or the Guacamole clipboard panel if direct copy-paste does not work in your browser.

Customizing Your Virtual Lab

To create a personalized virtual lab with custom software pre-installed, follow the same clone-customize-snapshot workflow used for workspaces:

  1. Clone the Ubuntu Virtual Lab formation (right-click > Clone)
  2. Launch your cloned formation
  3. Install software and configure the desktop to your needs
  4. Snapshot the session (right-click session > Create Machine Image)
  5. Share the formation with others

See Create a Custom Linux Workspace for detailed instructions on each step of this workflow.

Managing Your Session

Stopping the Session

When you are finished working, shut down the session to stop compute costs:

  1. Right-click your running session in the Sessions panel
  2. Select Shutdown

Warning

Running virtual labs incur hourly compute costs. Always shut down when you are not actively using the desktop.

Reconnecting

If your browser tab is closed while the session is still running, simply click the session again in the Sessions panel to reconnect. Your desktop state is preserved.

Next Steps

Troubleshooting

Desktop does not load in the browser

Ensure that:

  • The session shows a green tick (fully provisioned)
  • Your browser allows pop-ups from the RosettaHub domain
  • You are using a modern, up-to-date browser (Chrome, Firefox, Edge, or Safari)
  • Your network does not block WebSocket connections (required for VNC/Guacamole)

Try refreshing the tab or closing and reopening it from the Sessions panel.

Desktop is slow or unresponsive

Performance depends on several factors:

  • Network latency - Choose a cloud region closer to your physical location
  • Instance type - Select a larger instance type with more CPU and memory
  • Browser - Chrome and Firefox generally provide the best performance
  • Other tabs - Close unnecessary browser tabs to free local resources
Copy-paste does not work between local and remote

Clipboard integration depends on your browser's permissions:

  • Allow clipboard access when your browser prompts for it
  • Use the Guacamole clipboard panel (accessible via the side menu) as an alternative
  • Some browsers restrict clipboard access in certain security contexts
Session shows green tick but clicking does not open the desktop

This may be caused by:

  • A pop-up blocker preventing the new tab from opening
  • Browser extensions interfering with the connection
  • Try right-clicking the session and selecting the connection option explicitly