Prerequisites
- You need a robot arm such as the SO-100, the SO-101, or other compatible hardware. Get the phosphot starter pack here.
- Install the phosphobot software on your computer.
- Connect robots to your computer. Start the phosphobot server.
- Complete the quickstart and check that you can control your robot.
- The phosphobot teleoperation app is installed on your Meta Quest 2, Pro, 3 or 3s. >
Subscribe to phospho pro to unlock VR control
Unlock access to VR Control, advanced AI training, and more.
Lifetime access to the phospho teleoperation app
Get the phospho teleoperation app on the Meta Store for Meta Quest 2, Pro, 3, and 3s.
If you bought our phospho starter pack, you should have received a link to get the phospho teleoperation Meta Quest app. Please reach out if not.
- An ngrok account. Sign up here (or use an alternative like Cloudflare Tunnel).
- The ngrok CLI installed on your device. Download it here
1. Authenticate ngrok
To use ngrok, you need to authenticate your account. Open a terminal and run the following command:YOUR_AUTH_TOKEN
with the token provided in your ngrok dashboard.
2. Create an ngrok Tunnel for your control module
- Ensure your phosphobot server is running and connected to the internet. If you’re using the control module, turn it on.
-
SSH into your phosphobot. By default, the password is
password123
-
Run the following command to create a tunnel:
This command tells ngrok to forward traffic from the internet to your local server running on port 80.
-
Once the tunnel is active, ngrok will display a forwarding URL in the terminal, such as:
This URL is publicly accessible from anywhere in the world and will remain active while the ngrok tunnel is running. Turn off the server to stop the tunnel.
3. Access Your Teleoperation App Remotely
- Copy the ngrok
https://
URL displayed in your terminal (e.g.,https://abc123.ngrok.io
). - Share this URL with users who need remote access to your teleoperation app.
- Open the URL in a browser to access the Admin panel.
- In the Meta Quest app, go to
Settings
and enter the ngrok URL to connect.
Ensure your local server remains running while the ngrok tunnel is active. Closing the server will break the connection.
4. Secure Your Tunnel
By default, ngrok tunnels are public, meaning anyone with the URL can control your robot and access datasets.
-
Add basic authentication
Run the following command to require a username and password to access the tunnel:
Replace
username
andpassword
with your desired credentials. -
Alternatively, you can restrict access to specific IP addresses.
- Go to the ngrok dashboard
- Use the IP restrictions feature in the dashboard.
5. Monitor Traffic (Optional)
Ngrok provides a web interface for inspecting traffic and requests. To access it:- Open your browser and go to
http://localhost:4040
. - Here, you can view detailed logs of incoming requests and responses.
What’s Next?
Now that your teleoperation app is accessible remotely, you can:- Share the ngrok URL with collaborators for real-time teleoperation.
- Record datasets remotely and upload them to your Hugging Face account.
- Train AI models using the data collected from remote sessions.
Train Your First AI Model
Learn how to use your recorded datasets to train your first AI model.