# Establish a Connection With Your Lattice1 via SSH

{% hint style="success" %}
Before you start, make sure your Lattice1 is **connected to your router** either through WiFi or Ethernet. Also, make sure you can communicate with your router through your computer.
{% endhint %}

If you want to change any network configuration or run software on your Lattice's router chip, which is a very lightweight Linux environment, you can **SSH into your device** using the following steps:

1. On your Lattice screen, go to **System Preferences → Device Info.**
2. The parameters you will want to use are "**SSH Host**" and "**SSH Password**".
3. Open a terminal on your computer and type this **SSH command**: `ssh root@<SSH Host>.local` (just what you see under SSH Host without the <> marks)
4. If this is your first time, it will ask you add the **RSA key**. Type `yes` and hit enter.
5. You will be asked for the **password** - type in the `<SSH Password>` from your Lattice1 screen. Again, only the password itself, not the <> marks. Please note you might **not see your input** on this step, but type the password in and hit enter and you should be okay.
6. If successful, you will see a **welcome prompt** with Lattice1 ASCII art and information about the GCE version. This is how the whole process should look on your terminal:

![](/files/-MaEyBq0hZVSDwQt4iM6)

Done, you can now **control your Lattice’s Linux environment**: update configurations, run whatever software you want, or just poke around under the hood.

But if you’re looking for your private keys, [**you’ll be out of luck**](/lattice1/security-features.md)!

### Troubleshooting

{% hint style="danger" %}
If you can't ping the Lattice1 through **your router,** your router is probably not configured for **mDNS** - the protocol that allows devices to broadcast their hostname on the local router network and for the router to rebroadcast it to other devices - which allows you to search for devices with the **'.local' suffix**.

To solve this, please check your router's user manual and look for enabling mDNS.

You can still communicate with the device even **without mDNS enabled**, but you will have to use the device's **IP address** instead of the hostname - so the command `ssh root@GridPlus-xyz123.local`would become`ssh root@123.456.789.012`.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.gridplus.io/lattice1/lattice1-guides/how-to-communicate-with-your-lattice1-via-ssh.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.