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

# Connecting via SSH

SSH gives you a terminal directly on the robot. Everything below assumes you know two things:

|              |           |
| ------------ | --------- |
| **Username** | `jetson1` |
| **Password** | `goodbot` |

## Via Wi-Fi

<Steps>
  <Step title="Join the same network">
    Make sure your computer and MARS are on the same Wi-Fi network (or your phone hotspot).
  </Step>

  <Step title="Find your robot's hostname">
    Open the Innate app → **Configuration** → **WiFi** → **Current hostname**.

    No custom name yet? The default is `mars`, i.e. `mars.local`.
  </Step>

  <Step title="Connect">
    ```bash theme={null}
    ssh jetson1@<hostname>.local
    ```

    Enter the password `goodbot` when prompted.
  </Step>
</Steps>

<Accordion title="How robot names map to hostnames">
  The hostname is derived from the robot's display name:

  * Uppercase letters become lowercase
  * Spaces and special characters become `-`
  * Duplicate hyphens are collapsed; leading/trailing hyphens are removed

  | Robot name | Hostname         | SSH command                  |
  | ---------- | ---------------- | ---------------------------- |
  | `My Robot` | `my-robot.local` | `ssh jetson1@my-robot.local` |
  | `MARS_01`  | `mars-01.local`  | `ssh jetson1@mars-01.local`  |
  | `Test Bot` | `test-bot.local` | `ssh jetson1@test-bot.local` |
</Accordion>

<Tip>
  Set up SSH keys so you never type the password again:

  ```bash theme={null}
  ssh-copy-id jetson1@<hostname>.local
  ```
</Tip>

## Via Ethernet (preferred wired method)

<Steps>
  <Step title="Connect Ethernet cable">
    Connect an Ethernet cable between your computer and MARS.
  </Step>

  <Step title="Set static IP on your computer">
    Configure your Ethernet interface to `192.168.50.1` with netmask `255.255.255.0`.
  </Step>

  <Step title="SSH to MARS">
    Run `ssh jetson1@192.168.50.2`.
  </Step>
</Steps>

### Static IP setup by OS

<Tabs>
  <Tab title="Windows">
    <Steps>
      <Step title="Open adapter settings">
        Go to **Settings** -> **Network & Internet** -> **Advanced network settings** -> **More network adapter options**.
      </Step>

      <Step title="Open Ethernet properties">
        Right-click **Ethernet** -> **Properties**.
      </Step>

      <Step title="Edit IPv4">
        Open **Internet Protocol Version 4 (IPv4)** and select manual IP configuration.
      </Step>

      <Step title="Set values">
        IP: `192.168.50.1`, Subnet mask: `255.255.255.0`, Gateway/DNS: leave empty.
      </Step>

      <Step title="Apply">
        Save and reconnect Ethernet if needed.
      </Step>
    </Steps>
  </Tab>

  <Tab title="macOS">
    <Steps>
      <Step title="Open Ethernet settings">
        Go to **System Settings** -> **Network** -> **Ethernet**.
      </Step>

      <Step title="Open TCP/IP">
        Click **Details** -> **TCP/IP**.
      </Step>

      <Step title="Set manual IPv4">
        Configure IPv4 manually with IP `192.168.50.1` and subnet mask `255.255.255.0`; leave router empty.
      </Step>

      <Step title="Optional DNS cleanup">
        In **Details** -> **DNS**, remove DNS servers if you do not want Ethernet to affect internet routing.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Ubuntu">
    <Steps>
      <Step title="Open wired settings">
        Go to **Settings** -> **Network** -> **Wired** and click the gear icon.
      </Step>

      <Step title="Configure IPv4 manually">
        Set method to manual, address `192.168.50.1`, netmask `255.255.255.0`, and leave gateway/DNS empty.
      </Step>

      <Step title="Apply">
        Save and toggle wired OFF/ON.
      </Step>
    </Steps>
  </Tab>
</Tabs>

## Via USB-C (last resort)

USB-C is not recommended. Use this only when Wi-Fi and Ethernet are unavailable.

<Accordion title="Show USB-C connection instructions">
  <Steps>
    <Step title="Connect USB-C">
      Connect a USB-C cable between your computer and the Jetson USB-C port on MARS.
    </Step>

    <Step title="Use USB network address">
      The Jetson exposes a USB network interface at `192.168.55.1`.
    </Step>

    <Step title="SSH to Jetson">
      Run `ssh jetson1@192.168.55.1`.
    </Step>
  </Steps>

  This mode is useful for first-time recovery or network debugging.
</Accordion>