Skip to main content
When you have a confirmed reservation, Ornn lets you choose how your GPU hardware is materialized and made accessible. You set this choice per reservation from the reservation detail page (/portfolio/[reservationId]).

​
Available access modes

Two access modes are implemented today:
Confirmed reservationset per reservation on the detail page

​
VM

Managed virtual machine on your reserved hardware. Ornn base image (Ubuntu, CUDA, PyTorch) or an approved custom image. SSH into the VM.

​
Bare Metal

Direct SSH to the physical host. No virtualization layer; you manage the software environment yourself.

VMBare Metal
Use caseMost ML training and inference workloadsWorkloads that need direct hardware control or maximum throughput
Performance profileNear-bare-metal; slight virtualization overheadNo virtualization, direct physical host
Image optionsOrnn base image (Ubuntu + CUDA + PyTorch) or an approved custom imageNo image; you manage the software environment directly
Recommended forMost Ornn customersAdvanced users who need full hardware control
Need a cluster instead of a single machine? You can also launch a managed Kubernetes or Slurm cluster across your reserved GPU nodes from the Clusters page.

​
Prerequisites

Before you can configure an access mode for a reservation, the following must be true:
  • The bid has been promoted to a confirmed reservation, and the reservation is visible in your portfolio.
  • Checkout and payment for the reservation are complete. Access cannot be launched or changed on a reservation with outstanding payment.
  • Your account has at least one active SSH public key registered. Add keys from the SSH keys tab on the Account page or with ornn ssh-keys add. See Manage SSH keys.

​
Configure the access mode

1

Open the reservation detail page

From your Portfolio (/portfolio), click View on the reservation you want to configure. The detail page opens at /portfolio/[reservationId]. The legacy /portfolio/access URL redirects here.
2

Choose VM or Bare Metal

Pick the access mode you want from the access section. VM and Bare Metal cannot run simultaneously on the same reservation.
3

Add an SSH key and launch

In the SSH Keys section, click Add Key to add a key to the reservation, or confirm one is already there. Then launch. Ornn authorizes the reservation’s active keys on the host.
4

Wait for the host to be ready

Provisioning takes a few minutes. The SSH Host and User fields (plus a ready-to-run Quick Connect command) appear in the Connect section of the reservation detail page once the host is ready.
The CLI’s ornn access commands (activate, show, push-keys) cover Bare Metal only. ornn access activate <reservation-id> --ssh-key-id <key-id> performs the initial Bare Metal launch and installs the first key. VM access is configured and launched from the reservation detail page in the web app; there is no ornn access equivalent for VM.

​
Connecting over SSH

Once the host is ready, connect with your preferred SSH client: 
ssh <tenant-username>@<ssh-endpoint>
The values for these placeholders come from the SSH Host and User fields in the Connect section of the reservation detail page. From the CLI you can also fetch them on demand: 
ornn access show <reservation-id>
ornn access show <reservation-id> --json

​
Save the connection in ~/.ssh/config

For repeated access, add a Host entry to your local SSH config: 
Host ornn-h100
  HostName <ssh-endpoint>
  User <tenant-username>
  IdentityFile ~/.ssh/id_ed25519
  IdentitiesOnly yes
  ServerAliveInterval 60
Then connect with ssh ornn-h100.

​
Port forwarding

Forward a local port to a service running on the host (for example, a Jupyter server on port 8888): 
ssh -L 8888:localhost:8888 <tenant-username>@<ssh-endpoint>

​
Copying files

Move data on and off the host with scp or rsync: 
scp ./dataset.tar.gz <tenant-username>@<ssh-endpoint>:/data/
rsync -avh ./project/ <tenant-username>@<ssh-endpoint>:/home/<tenant-username>/project/

​
After you connect

Verify the GPUs are visible to the host: 
nvidia-smi
You should see your allocated GPUs listed with driver and CUDA versions. If you’re on the Ornn base image, PyTorch is already available: 
python -c "import torch; print(torch.cuda.is_available(), torch.cuda.device_count())"

​
Adding more keys to a running reservation

If a teammate needs to connect to the same host, or if you want to rotate keys, push another registered key onto a launched reservation: 
ornn access push-keys <reservation-id> --ssh-key-id <key-id>
The newly pushed key is authorized alongside any keys already on the host.

​
Switching access modes

You can switch between VM and Bare Metal on the same reservation, but it tears down the current environment.
Switching access modes after launch tears down the existing environment. Anything stored on the previous mode that has not been persisted off the host will be lost. Copy out any data you need first.
To switch: open the reservation detail page, pick the other mode, make sure the reservation has an active SSH key, and launch.

​
Data persistence

Ornn does not snapshot or back up data stored on the host. Treat the host as ephemeral within the reservation term:
  • Persist datasets and checkpoints to your own object storage (S3, GCS, R2, etc.) regularly.
  • Save before switching access modes; switching tears the environment down.
  • At the end of the reservation term, the host is released and any data on it is no longer accessible.

​
Troubleshooting

The SSH key you’re connecting with isn’t authorized on the host. Confirm the key you attached to the reservation matches the private key your SSH client is using:
ssh -i ~/.ssh/id_ed25519 -v <tenant-username>@<ssh-endpoint>
To push a different registered key onto the host, run ornn access push-keys <reservation-id> --ssh-key-id <key-id>.
The host may still be provisioning. Check the reservation detail page. If the SSH Host field isn’t visible yet, wait a few minutes and retry. If the host is shown but unreachable, verify your local network allows outbound SSH on the listed port.
If you reconnect after switching access modes or relaunching, the host key may change. Remove the old entry from ~/.ssh/known_hosts and reconnect:
ssh-keygen -R <ssh-endpoint>
On the Ornn base image this should never happen; file a support ticket. On a custom image or Bare Metal, confirm NVIDIA drivers are installed and loaded (lsmod | grep nvidia) and that the kernel matches the driver build.
Access setup is gated on completed checkout/payment and at least one registered SSH key. Confirm both: check Account → Billing for outstanding invoices, and the SSH keys tab for at least one active key.

​
Learn more

vm-access

VM access

Launch a managed VM with the Ornn base image or an approved custom image.
bare-metal-access

Bare Metal access

SSH directly into the GPU host for maximum performance with no virtualization overhead.
ssh-keys

Manage SSH keys

Register the public key you’ll attach to a reservation before launch.
checkout

Completing checkout

Finish payment so access mode changes are unlocked for your reservation.