GitHub

Remote access

Remote access allows users to connect to their build’s virtual machines via SSH or a screenshare app. A failed build can be rebuilt with remote access enabled to make troubleshooting a lot easier - for example, if the build logs don’t provide enough information about the error.

Authorization

Users who have the Testers/QA roles on the app CANNOT use remote access.

There are two ways to use remote access on our build machines:

With either method, you can access the build machine remotely during the build and for 10 minutes after the build is finished.

Remote access with SSH

  1. Go to the build page.
  2. Click the Rebuild with Remote Access option.
  3. Click Remote Access Instructions.

  4. Under the SSH option, find and copy the command you will need.
  5. Open a command line interface.
  6. Run the command found under SSH (the below is an example):

    ssh -o StrictHostKeyChecking=no vagrant@1.tcp.ngrok.io -p 000000
    
  7. Copy and paste the password from the Remote Access Instructions page.

And done! You should be able to access the virtual machine where your build is running.

Remote access with screenshare

  1. Go to the build page.
  2. Click the Rebuild with Remote Access option.
  3. Click Remote Access Instructions.

  4. Under the Screenshare option, find the required information:
    • Address
    • Username
    • Password
  5. Open a VNC screenshare application.

    The simplest option is using the default Screen Sharing application on macOS.

  6. Fill out the required fields with the information from under the Screenshare option.

And done! You should now be able to access the virtual machine where your build is running.