Simulation Setup

This guide walks you through setting up the Gazebo simulation used in the Your First Project tutorial.

If you run into trouble getting this working, reach out on discord or at **TODO**@viam.com.

Step 1: Start a Simulation Environment

Visit cans.viam-labs.com, and follow the prompts to log in. Wait for your instance to start.

Step 2: Verify the Simulation

When your instance is finished starting, you should see two live camera feeds from the inspection station:

Step 3: Create a Machine in Viam

1. Go to app.viam.com and create a free account or log in

2. Click the Locations tab

3. Click + Add machine, name it inspection-station-1, and click Add machine

   

Step 4: Configure Machine Credentials

1. In the Viam app, click the Awaiting setup button on your new machine and click Machine cloud credentials to copy the credentials JSON

   

2. In the simulation viewer, click the Configuration button in the upper right corner

   

3. Paste your machine’s credentials into the Viam Configuration (viam.json) text area and click Update and Restart

   

   A green banner will confirm the configuration was updated successfully and the status indicator will change to Running.

   

Step 5: Verify Machine Connection

Go back to your machine’s page in the Viam app. The status indicator should now show Live.

Ready to Continue

Once your machine shows Live in the Viam app, you’re ready to continue with the tutorial.

Continue to Part 1: Vision Pipeline →