Docs menu

SSH in the browser

Open a terminal on a car or the pit PC from any browser with Cloudflare's browser-rendered SSH, with nothing to install.

The standard way to get a terminal on a car or the pit PC is Cloudflare’s browser-rendered SSH. Cloudflare runs the SSH client and draws the terminal in a browser tab, so it works from any computer, including a lab or library machine where you cannot install software.

Connect

  1. Open the SSH route for the device you need, from the table below.
  2. Sign in at the Cloudflare Access page with your approved email address.
  3. Enter the device username, then the password, from your team lead.

Working when: the tab shows a shell prompt on the device. Run hostname to check which one you are on.

Devices

Device Hostname SSH URL
Car 1 racerbotcar-1 ssh-rb1.sfuracerbot.ca
Car 2 racerbotcar-2 ssh-rb2.sfuracerbot.ca
Pit PC racerbotpitpc ssh-pitpc.sfuracerbot.ca

The session closes when the tab closes. Run anything that has to outlive the tab, such as a long build or a launch, inside tmux (see Terminal tools on the cars), and reattach to it from the next session.

Troubleshooting

Symptom Cause Fix
The sign-in page keeps coming back Your email address is not on the team list, or you signed in with a different account Sign in with the address you gave @it-services, or ask them to check the list
The page loads but the terminal never connects The device is off or has no internet, so its tunnel is down Check the device is powered on and on the network; ask in Discord who has it
Permission denied after the password Wrong device username or password Ask your team lead for the current login

Limitations

  • Copy and paste go through the browser. Some browsers ask for clipboard permission the first time you paste into the terminal.
  • The browser terminal cannot forward ports or copy files. Use SSH from VS Code or a terminal for those.