> ## Documentation Index
> Fetch the complete documentation index at: https://altostrat.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Onboard Your First Router

> Create your first SDX site, run the bootstrap command on RouterOS, and verify that the router is online.

Use this guide to onboard one MikroTik router as an SDX site. By the end, the router should appear as online in the portal and be ready for management, monitoring, backups, policies, and automation.

## Prerequisites

Before you begin, make sure you have:

<Checklist>
  * A MikroTik router with working outbound internet access.
  * RouterOS terminal access through WinBox, SSH, or a local console.
  * An Altostrat SDX user with permission to create and manage sites.
  * A control plane policy to apply during onboarding. The default policy is suitable for a first site unless your organization has a stricter standard.
</Checklist>

<Warning>
  Run onboarding during a maintenance window if the router is already carrying production traffic. The bootstrap script installs SDX management configuration and may change management-plane behavior.
</Warning>

## Onboard the Router

<Steps>
  <Step title="Create the site">
    Create the logical site that will represent this router in SDX.

    1. Open the SDX portal.
    2. Go to **Sites**.
    3. Select **Add**.
    4. Enter a clear site name, such as the location or customer-facing service name.
    5. Save the site.

    Use a name your operations team will recognize in alerts and reports. You can add tags and notes after the site is online.

    <Frame>
      <img className="block dark:hidden" src="https://mintcdn.com/altostratnetworks/Mm408vpquyLAVx3p/images/getting-started/adding-a-router/getting_started_adding-a-router-step2_light.jpg?fit=max&auto=format&n=Mm408vpquyLAVx3p&q=85&s=0cc32bbf15191f214881c9eaa8b688c0" alt="Create a new site in the SDX portal" width="1440" height="900" data-path="images/getting-started/adding-a-router/getting_started_adding-a-router-step2_light.jpg" />

      <img className="hidden dark:block" src="https://mintcdn.com/altostratnetworks/Mm408vpquyLAVx3p/images/getting-started/adding-a-router/getting_started_adding-a-router-step2_dark.jpg?fit=max&auto=format&n=Mm408vpquyLAVx3p&q=85&s=c8e1951bafd215a75ed788557927718a" alt="Create a new site in the SDX portal" width="1765" height="767" data-path="images/getting-started/adding-a-router/getting_started_adding-a-router-step2_dark.jpg" />
    </Frame>
  </Step>

  <Step title="Generate the bootstrap command">
    Generate the RouterOS command that binds the physical router to the site.

    1. Open the new site.
    2. Select **Add Router** or the onboarding action shown in the site view.
    3. Select the control plane policy you want SDX to enforce.
    4. Copy the generated bootstrap command.

    <Frame>
      <img className="block dark:hidden" src="https://mintcdn.com/altostratnetworks/Mm408vpquyLAVx3p/images/getting-started/adding-a-router/getting_started_adding-a-router-step6_light.jpg?fit=max&auto=format&n=Mm408vpquyLAVx3p&q=85&s=d59ce3b83b412a23a0aaafa6cb036691" alt="Bootstrap command generated for a new SDX site" width="769" height="594" data-path="images/getting-started/adding-a-router/getting_started_adding-a-router-step6_light.jpg" />

      <img className="hidden dark:block" src="https://mintcdn.com/altostratnetworks/Mm408vpquyLAVx3p/images/getting-started/adding-a-router/getting_started_adding-a-router-step6_dark.jpg?fit=max&auto=format&n=Mm408vpquyLAVx3p&q=85&s=80a1eadfcd45b993237a563f76417565" alt="Bootstrap command generated for a new SDX site" width="770" height="592" data-path="images/getting-started/adding-a-router/getting_started_adding-a-router-step6_dark.jpg" />
    </Frame>

    <Tip>
      The bootstrap command is site-specific. If you abandon the onboarding attempt or suspect the command was copied incorrectly, generate a fresh command from the portal.
    </Tip>
  </Step>

  <Step title="Run the command on RouterOS">
    Execute the command on the target router.

    1. Open the router terminal through WinBox, SSH, or console.
    2. Paste the full bootstrap command.
    3. Press **Enter**.
    4. Wait for the command to finish before closing the session.

    The router connects outbound to Altostrat, adopts into the site, and begins the management relationship used for heartbeats and device jobs.

    <Frame>
      <img src="https://mintcdn.com/altostratnetworks/Mm408vpquyLAVx3p/images/getting-started/adding-a-router/getting_started_adding-a-router-step7.jpg?fit=max&auto=format&n=Mm408vpquyLAVx3p&q=85&s=1ea123513a7d57085a4512ac47da98b9" alt="RouterOS terminal running the SDX bootstrap command" width="1193" height="693" data-path="images/getting-started/adding-a-router/getting_started_adding-a-router-step7.jpg" />
    </Frame>
  </Step>

  <Step title="Verify the site is online">
    Return to the SDX portal and open the site.

    Confirm that:

    * The site status changes to online.
    * Last seen updates after the router checks in.
    * Device identity and RouterOS details appear on the site.
    * The site appears in the fleet list and dashboard widgets.

    <Frame>
      <img className="block dark:hidden" src="https://mintcdn.com/altostratnetworks/Mm408vpquyLAVx3p/images/getting-started/adding-a-router/getting_started_adding-a-router-step8_light.jpg?fit=max&auto=format&n=Mm408vpquyLAVx3p&q=85&s=fe11ce8d08e7504b72c68e918db3187c" alt="SDX site shown as online after onboarding" width="861" height="292" data-path="images/getting-started/adding-a-router/getting_started_adding-a-router-step8_light.jpg" />

      <img className="hidden dark:block" src="https://mintcdn.com/altostratnetworks/Mm408vpquyLAVx3p/images/getting-started/adding-a-router/getting_started_adding-a-router-step8_dark.jpg?fit=max&auto=format&n=Mm408vpquyLAVx3p&q=85&s=b8f9d0f8a6daabc83c472afb68096e67" alt="SDX site shown as online after onboarding" width="805" height="290" data-path="images/getting-started/adding-a-router/getting_started_adding-a-router-step8_dark.jpg" />
    </Frame>

    <Note>
      If the site does not come online, start with outbound internet reachability, DNS resolution, the full copied command, and outbound access to the management VPN endpoint. See [Troubleshooting](../resources/troubleshooting) for a structured checklist.
    </Note>
  </Step>
</Steps>

## Next Steps

After the router is online, do these next:

<CardGroup cols={2}>
  <Card title="Review the Site" icon="map-pin" href="../fleet/managing-sites-devices" arrow="true">
    Learn where SDX shows status, inventory, notes, tags, faults, metrics, and site settings.
  </Card>

  <Card title="Harden Management Access" icon="shield-check" href="../fleet/control-plane-policies" arrow="true">
    Review the control plane policy applied during onboarding and create a stricter one if needed.
  </Card>

  <Card title="Create a Backup" icon="archive" href="../fleet/configuration-backups" arrow="true">
    Request and review a configuration backup before making larger changes.
  </Card>

  <Card title="Plan Tags" icon="tags" href="../fleet/metadata-and-tags" arrow="true">
    Add useful operational metadata before you build reports and workflows around the site.
  </Card>
</CardGroup>
