Working in an instance¶

Access your instance¶

After creating your instance, there are several ways to access it.
You can also find all of the methods listed here in the README inside your instance workspace.

VS Code Web IDE¶

The easiest way is to use the web-based VS Code interface. You can open it using the corresponding button in your instance tile in the Instance Overview.

Virtual Desktop¶

A graphical desktop environment via noVNC is also available. You can access it using the corresponding button in your instance tile in the Instance Overview.

SSH (Recommended)¶

You can also access your EXPLORE instance via SSH — both through a classic terminal and through the Remote Explorer extension for VS Code (or other IDEs). The required command, which already contains all necessary information, can conveniently be copied from the bottom section of your instance tile in the Instance Overview.

Isaac Sim Viewer¶

Once you have started Isaac Sim, the graphical interface is provided through the Isaac Sim Viewer by default. The viewer can be accessed using the corresponding button in your instance tile in the Instance Overview.

File handling¶

Important: Please also make sure to read the notes regarding files in the Instance Lifecycle overview!

Files are not shared between different instances by default. An exception is the shared persistent volume:

Mount Path: /workspace/shared
Access Mode: ReadWriteMany (RWX) - multiple instances can read and write simultaneously

File copying via scp/rsync¶

To copy files into your instance (and back out again), you can use scp (or rsync).
You can find the SSH port and your node DNS name in the SSH command shown at the bottom section of your instance tile in the Instance Overview.

scp -p <SSH_PORT> <local_file> <username>@<node-hostname>:/workspace/shared
scp -p <SSH_PORT> <username>@<node-hostname>:/workspace/shared/<remote_file> <local_path>

Git¶

You can also use Git to quickly and conveniently make files available inside your EXPLORE instance. Simply clone your repository into your instance workspace.

Isaac Usage¶

Isaac Sim and Isaac Lab are directly available in your instance by default.

Running Isaac Sim¶

Open a terminal (using one of the methods described above) and enter or paste the following command:

/isaac-sim/isaac-sim.sh $STREAM_ARGS

This starts Isaac Sim with the correct streaming options. When you see the output Isaac Sim Full App is loaded., the application is ready for streaming and you should be able to access the graphical interface using the Isaac Sim Viewer described above.

Running Isaac Sim (Virtual Desktop)¶

If you want to use Isaac Sim through the virtual desktop, you can start the script without $STREAM_ARGS:

/isaac-sim/isaac-sim.sh

Running Isaac Lab¶

You can run Isaac Lab scripts with the streaming Isaac Sim viewer:

/isaaclab/isaaclab.sh -p "isaaclab/scripts/tutorials/00_sim/create_empty.py" --kit_args="${STREAM_ARGS}"

To run any other Isaac Lab commands, simply append them as shown above.

Others¶

Background Processes¶

Processes started in any remote terminal will pause when you close the terminal. To run processes in the background, use tools like tmux or screen.

Software Installation¶

Users have sudo permissions and can install packages using:

sudo apt update
sudo apt install <package-name>