Update inbound markdown links to first-machine

shannonbradshaw · claude · shannonbradshaw · commit 61660c146a08 · 2026-04-25T21:34:26.000-04:00
htmltest doesn't accept Hugo alias redirects as valid link targets;
inbound markdown links across tutorials and device-setup pages need
to point at the new canonical URL. The alias on first-machine.md
stays for external bookmarks.

Co-Authored-By: Claude Opus 4.7 (1M context) &lt;noreply@anthropic.com&gt;
diff --git a/docs/reference/device-setup/beaglebone-setup.md b/docs/reference/device-setup/beaglebone-setup.md
@@ -83,7 +83,7 @@ After SSH'ing into your BeagleBone, verify all packages are up to date:
 ## Next steps
 
 You have now installed an operating system on your BeagleBone.
-To use your BeagleBone, follow the [setup guide](/set-up-a-machine/overview/):
+To use your BeagleBone, follow the [setup guide](/set-up-a-machine/first-machine/):
 
 {{< cards >}}
 {{% card link="/set-up-a-machine/first-machine/" %}}
diff --git a/docs/reference/device-setup/board1-setup.md b/docs/reference/device-setup/board1-setup.md
@@ -61,7 +61,7 @@ Once you're connected to your board, you can verify all packages are up to date
 ## Next steps
 
 You have now installed an operating system on your BOARD.
-To use your BOARD, follow the [setup guide](/set-up-a-machine/overview/):
+To use your BOARD, follow the [setup guide](/set-up-a-machine/first-machine/):
 
 {{< cards >}}
 {{% card link="/set-up-a-machine/first-machine/" %}}
diff --git a/docs/reference/device-setup/jetson-agx-orin-setup.md b/docs/reference/device-setup/jetson-agx-orin-setup.md
@@ -119,7 +119,7 @@ See NVIDIA's documentation on [Configuring the Jetson Expansion Headers](https:/
 ## Next steps
 
 You have now installed an operating system on your Jetson board.
-To use your Jetson board, follow the [setup guide](/set-up-a-machine/overview/):
+To use your Jetson board, follow the [setup guide](/set-up-a-machine/first-machine/):
 
 {{< cards >}}
 {{% card link="/set-up-a-machine/first-machine/" %}}
diff --git a/docs/reference/device-setup/jetson-nano-setup.md b/docs/reference/device-setup/jetson-nano-setup.md
@@ -99,7 +99,7 @@ See NVIDIA's documentation on [Configuring the Jetson Expansion Headers](https:/
 ## Next steps
 
 You have now installed an operating system on your Jetson board.
-To use your Jetson board, follow the [setup guide](/set-up-a-machine/overview/):
+To use your Jetson board, follow the [setup guide](/set-up-a-machine/first-machine/):
 
 {{< cards >}}
 {{% card link="/set-up-a-machine/first-machine/" %}}
diff --git a/docs/reference/device-setup/orange-pi-3-lts.md b/docs/reference/device-setup/orange-pi-3-lts.md
@@ -48,7 +48,7 @@ Before you power the board, you need to install an operating system.
 1. Follow the [Orange Pi guide to prepare your microSD card](https://sbc-community.org/docs/general_guides/prepare_sd_card/) to flash the OS to your micro-SD card using [balenaEtcher](https://etcher.balena.io/).
 
    {{< alert title="Tip: How to think about building a machine" color="tip" >}}
-   While flashing your microSD card, we recommend reading [How to think about building a machine](/set-up-a-machine/overview/).
+   While flashing your microSD card, we recommend reading [How to think about building a machine](/set-up-a-machine/first-machine/).
    {{< /alert >}}
 
 1. Insert the micro-SD into the Orange Pi.
@@ -85,7 +85,7 @@ For more information, consult the [official user manual](https://drive.google.co
 ## Next steps
 
 You have now installed an operating system on your Orange Pi.
-To use your Orange Pi, follow the [setup guide](/set-up-a-machine/overview/):
+To use your Orange Pi, follow the [setup guide](/set-up-a-machine/first-machine/):
 
 {{< cards >}}
 {{% card link="/set-up-a-machine/first-machine/" %}}
diff --git a/docs/reference/device-setup/orange-pi-zero2.md b/docs/reference/device-setup/orange-pi-zero2.md
@@ -47,7 +47,7 @@ Before you power the board, you need to install an operating system.
 1. Insert the micro-SD card into the SD card reader and connect the reader to your development machine.
 1. Follow [this guide](https://sbc-community.org/docs/general_guides/prepare_sd_card/) to flash the OS to your micro-SD card using [balenaEtcher](https://etcher.balena.io/).
    {{< alert title="Tip: How to think about building a machine" color="tip" >}}
-   While flashing your microSD card, we recommend reading [How to think about building a machine](/set-up-a-machine/overview/).
+   While flashing your microSD card, we recommend reading [How to think about building a machine](/set-up-a-machine/first-machine/).
    {{< /alert >}}
 1. Insert the micro-SD into the Orange Pi.
 
@@ -78,7 +78,7 @@ For more information, consult the [official user manual](https://drive.google.co
 ## Next steps
 
 You have now installed an operating system on your Orange Pi.
-To use your Orange Pi, follow the [setup guide](/set-up-a-machine/overview/):
+To use your Orange Pi, follow the [setup guide](/set-up-a-machine/first-machine/):
 
 {{< cards >}}
 {{% card link="/set-up-a-machine/first-machine/" %}}
diff --git a/docs/reference/device-setup/pumpkin.md b/docs/reference/device-setup/pumpkin.md
@@ -18,7 +18,7 @@ date: "2022-01-01"
 
 To use a [Mediatek Genio 500 Pumpkin single-board computer](https://ologicinc.com/portfolio/mediateki500/) with Viam:
 
-1. [Install `viam-server`](/set-up-a-machine/overview/) on your machine.
+1. [Install `viam-server`](/set-up-a-machine/first-machine/) on your machine.
 1. [Create a board definitions file](#create-a-board-definitions-file), specifying the mapping between your board's GPIO pins and connected hardware.
 1. [Configure a `customlinux` board](#configure-a-customlinux-board) on your machine, specifying the path to the definitions file in the board configuration.
 
diff --git a/docs/reference/device-setup/rpi-setup.md b/docs/reference/device-setup/rpi-setup.md
@@ -25,7 +25,7 @@ date: "2022-01-01"
 We recommend using Viam on a 64-bit Linux distribution.
 Support for older Raspberry Pis running on 32-bit ARM v7 is in beta.
 
-If you already have a Linux distribution installed on your {{< glossary_tooltip term_id="pi" text="Pi" >}}, you can skip ahead to [install `viam-server`](/set-up-a-machine/overview/).
+If you already have a Linux distribution installed on your {{< glossary_tooltip term_id="pi" text="Pi" >}}, you can skip ahead to [install `viam-server`](/set-up-a-machine/first-machine/).
 
 {{% expand "Click to check whether the Linux installation on your Raspberry Pi is 64-bit or 32-bit" %}}
 
@@ -35,7 +35,7 @@ Example output:
 
 {{< imgproc alt="Screenshot of a terminal running the 'lscpu' command. The output lists of this command on a Raspberry Pi. A red box highlights the command and the top of the output which reads 'Architecture: aarch64.'" src="/installation/rpi-setup/lscpu-output.png" resize="800x" declaredimensions=true class="shadow" >}}
 
-If the value of "Architecture: _'xxxxxx'_" ends in "64", you can skip ahead to [install `viam-server`](/set-up-a-machine/overview/).
+If the value of "Architecture: _'xxxxxx'_" ends in "64", you can skip ahead to [install `viam-server`](/set-up-a-machine/first-machine/).
 
 {{% /expand%}}
 
@@ -177,7 +177,7 @@ Be sure that you remember the `hostname` and `username` you set, as you will nee
 
     {{< alert title="Tip: How to think about building a machine" color="tip" >}}
 
-While the Imager is flashing your microSD card, we recommend reading [How to think about building a machine](/set-up-a-machine/overview/).
+While the Imager is flashing your microSD card, we recommend reading [How to think about building a machine](/set-up-a-machine/first-machine/).
 
     {{< /alert >}}
 
diff --git a/docs/reference/device-setup/sk-tda4vm.md b/docs/reference/device-setup/sk-tda4vm.md
@@ -63,7 +63,7 @@ You must extract the image from the zip file before flashing the microSD card.
    The flashing and verification process may take 10-20 minutes, depending on your system.
 
    {{< alert title="Tip: How to think about building a machine" color="tip" >}}
-   While the Etcher is flashing your microSD card, we recommend reading [How to think about building a machine](/set-up-a-machine/overview/).
+   While the Etcher is flashing your microSD card, we recommend reading [How to think about building a machine](/set-up-a-machine/first-machine/).
    {{< /alert >}}
 
 8. On completion of the flashing and validation process, remove the microSD card from your computer and insert it into the TDA4VM.
@@ -111,7 +111,7 @@ From the SSH session on the TDA4VM board:
 ## Next steps
 
 You have now installed an operating system on your board.
-To use your board, follow the [setup guide](/set-up-a-machine/overview/):
+To use your board, follow the [setup guide](/set-up-a-machine/first-machine/):
 
 {{< cards >}}
 {{% card link="/set-up-a-machine/first-machine/" %}}
diff --git a/docs/tutorials/configure/configure-rover.md b/docs/tutorials/configure/configure-rover.md
@@ -34,7 +34,7 @@ If you are using a Viam Rover, use the [Viam Rover tutorial fragment](/try/) ins
 ## Requirements
 
 - A running an instance of `viam-server`.
-  See our [Installation Guide](/set-up-a-machine/overview/) for instructions.
+  See our [Installation Guide](/set-up-a-machine/first-machine/) for instructions.
 - A rover like the [SCUTTLE robot](https://www.scuttlerobot.org/shop/) or the Yahboom 4WD Smart Robot.
 
 Make sure your rover is assembled before starting this tutorial.
diff --git a/docs/tutorials/control/air-quality-fleet.md b/docs/tutorials/control/air-quality-fleet.md
@@ -49,7 +49,7 @@ For each machine, you need the following hardware:
 
 - A [SDS011 Nova PM sensor](https://www.amazon.com/SDS011-Quality-Detection-Conditioning-Monitor/dp/B07FSDMRR5)
   - If you choose to use a different air quality sensor, you may need to [create your own module](/build-modules/write-a-driver-module/) implementing the [sensor API](/reference/components/sensor/) for your specific hardware.
-- A single-board computer (SBC) [capable of running `viam-server`](/set-up-a-machine/overview/)
+- A single-board computer (SBC) [capable of running `viam-server`](/set-up-a-machine/first-machine/)
 - An appropriate power supply
 
 ## Set up one device for development
@@ -88,7 +88,7 @@ Use the **...** menu next to edit the location name to `Development`, then click
 Connect a PM sensor to a USB port on the machine's SBC.
 Then connect your device to power.
 
-If the computer does not already have a Viam-compatible operating system installed, follow the [prerequisite section of the setup guide](/set-up-a-machine/overview/) to install a compatible operating system.
+If the computer does not already have a Viam-compatible operating system installed, follow the [prerequisite section of the setup guide](/set-up-a-machine/first-machine/) to install a compatible operating system.
 You _do not_ need to follow the "Install `viam-server`" section; you will do that in the next step!
 
 Enable serial communication so that the SBC can communicate with the air quality sensor.
diff --git a/docs/tutorials/control/drive-rover.md b/docs/tutorials/control/drive-rover.md
@@ -71,7 +71,7 @@ If you are running out of time during your session, you can [extend your rover s
 {{% tab name="Other Rover" %}}
 
 {{% alert title="Important" color="note" %}}
-If you are using your own robot for this tutorial instead of [borrowing one](https://app.viam.com/try), be sure to [follow the setup instructions and install `viam-server`](/set-up-a-machine/overview/) on it, and connect and [configure](/tutorials/configure/configure-rover/) its hardware before proceeding with this tutorial.
+If you are using your own robot for this tutorial instead of [borrowing one](https://app.viam.com/try), be sure to [follow the setup instructions and install `viam-server`](/set-up-a-machine/first-machine/) on it, and connect and [configure](/tutorials/configure/configure-rover/) its hardware before proceeding with this tutorial.
 {{% /alert %}}
 
 {{% /tab %}}
diff --git a/docs/tutorials/control/flutter-app.md b/docs/tutorials/control/flutter-app.md
@@ -41,9 +41,9 @@ As you work through this project you will learn the following:
 
 ## Requirements
 
-You do not need any hardware for this tutorial other than a computer capable of running [`viam-server`](/set-up-a-machine/overview/).
+You do not need any hardware for this tutorial other than a computer capable of running [`viam-server`](/set-up-a-machine/first-machine/).
 
-This tutorial assumes you already have a machine [configured](/set-up-a-machine/overview/).
+This tutorial assumes you already have a machine [configured](/set-up-a-machine/first-machine/).
 
 ## Set up your Flutter development environment
 
diff --git a/docs/tutorials/custom/controlling-an-intermode-rover-canbus.md b/docs/tutorials/custom/controlling-an-intermode-rover-canbus.md
@@ -76,7 +76,7 @@ The tutorial uses the following hardware:
 ### Machine setup
 
 Before you can use Viam on your device, you must ensure it has a supported operating system.
-See [Start a new machine](/set-up-a-machine/overview/) for platform requirements and instructions.
+See [Start a new machine](/set-up-a-machine/first-machine/) for platform requirements and instructions.
 
 {{% snippet "setup.md" %}}
 
diff --git a/docs/tutorials/get-started/servo-mousemover.md b/docs/tutorials/get-started/servo-mousemover.md
@@ -52,7 +52,7 @@ This project is a good place to begin if you're new to robotics and would like t
 
 ### Hardware
 
-- [Raspberry Pi with microSD card](https://a.co/d/bxEdcAT), with `viam-server` installed per our [installation guide](/set-up-a-machine/overview/)
+- [Raspberry Pi with microSD card](https://a.co/d/bxEdcAT), with `viam-server` installed per our [installation guide](/set-up-a-machine/first-machine/)
 - microSD card reader
 - [Continuous rotation servo](https://a.co/d/2w0u6rK) (we used the FS90R servo)
 - Wheel or arm for the servo (this comes in some of the FS90R packages)
diff --git a/docs/tutorials/projects/claw-game.md b/docs/tutorials/projects/claw-game.md
@@ -57,7 +57,7 @@ To build your own claw game machine, you need the following hardware:
 
 To build your own claw game machine, you need the following software:
 
-- [`viam-server`](/set-up-a-machine/overview/)
+- [`viam-server`](/set-up-a-machine/first-machine/)
 - [Python 3](https://www.python.org/download/releases/3.0/)
 - [pip](https://pip.pypa.io/en/stable/#)
 - [Viam Python SDK](https://python.viam.dev/)
diff --git a/docs/tutorials/projects/helmet.md b/docs/tutorials/projects/helmet.md
@@ -48,7 +48,7 @@ After completing this tutorial, you will:
 
 - A camera such as a standard USB webcam.
   You can also test the hard hat detection system using the webcam built into your laptop.
-- A computer capable of running [`viam-server`](/set-up-a-machine/overview/).
+- A computer capable of running [`viam-server`](/set-up-a-machine/first-machine/).
 
 ### Optional hardware
 
@@ -60,7 +60,7 @@ Note that your machine must be connected to the internet for data sync and email
 
 ### Required software
 
-- [`viam-server`](/set-up-a-machine/overview/)
+- [`viam-server`](/set-up-a-machine/first-machine/)
 - [Ultralytics YOLOv8](https://docs.ultralytics.com/), integrated with Viam using the [YOLOv8 modular service](https://github.com/viam-labs/YOLOv8)
 - [YOLOv8 Hard Hat Detection model](https://huggingface.co/keremberke/yolov8s-hard-hat-detection)
 - [`objectfilter-camera`](https://app.viam.com/module/felixr/object-filter) {{< glossary_tooltip term_id="modular-resource" text="modular resource" >}}
diff --git a/docs/tutorials/projects/send-security-photo.md b/docs/tutorials/projects/send-security-photo.md
@@ -40,7 +40,7 @@ You need the following hardware for this tutorial:
 You will use the following software in this tutorial:
 
 - [Python 3.8 or newer](https://www.python.org/downloads/)
-- [`viam-server`](/set-up-a-machine/overview/)
+- [`viam-server`](/set-up-a-machine/first-machine/)
 - [Viam Python SDK](https://python.viam.dev/)
   - The Viam Python SDK (software development kit) lets you control your Viam-powered machine by writing custom scripts in the Python programming language.
     Install the Viam Python SDK by following [these instructions](https://python.viam.dev/).
diff --git a/docs/tutorials/services/color-detection-scuttle.md b/docs/tutorials/services/color-detection-scuttle.md
@@ -163,7 +163,7 @@ Next, create a file named <file>main.py</file> with the sample code from the **C
 Then, save your file.
 
 Run the code to verify that the Viam SDK is properly installed and that the `viam-server` instance on your robot is live.
-If you haven't yet installed `viam-server`, follow the [installation guide](/set-up-a-machine/overview/) to install `viam-server` on your robot before proceeding with this tutorial.
+If you haven't yet installed `viam-server`, follow the [installation guide](/set-up-a-machine/first-machine/) to install `viam-server` on your robot before proceeding with this tutorial.
 
 You can run your code by typing the following into your terminal from the same directory as your `main.py` file:
 
diff --git a/docs/tutorials/services/navigate-with-rover-base.md b/docs/tutorials/services/navigate-with-rover-base.md
@@ -80,7 +80,7 @@ If you are using different hardware, the navigation setup process will be mostly
 
 {{% /alert %}}
 
-Before you start, make sure to create a machine on [Viam](https://app.viam.com) and [install `viam-server`](/set-up-a-machine/overview/) on your robot.
+Before you start, make sure to create a machine on [Viam](https://app.viam.com) and [install `viam-server`](/set-up-a-machine/first-machine/) on your robot.
 Also, make sure to physically connect your components together to your machine's computer and power it on.
 
 ## Configure the components you need
