> For the complete documentation index, see [llms.txt](https://resmocom.gitbook.io/product/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://resmocom.gitbook.io/product/integrations/tailscale-integration.md).

# Tailscale Integration

## Resmo + Tailscale Integration Fundamentals

<figure><img src="/files/azTGyRVDQpTZTjZaiyMt" alt=""><figcaption></figcaption></figure>

Resmo integrates with Tailscale to bring you complete asset visibility, security, and compliance in one place.

### What does Resmo offer to Tailscale users?

* Collect your directory assets like devices, tailnet keys, and DNS nameservers from your Tailscale account.
* Query your Tailscale devices, tailnet keys, DNS nameservers, and more using SQL and free text search.
* Set up custom rules and run custom SQL queries to improve asset visibility.
* Get notified on critical security rule changes in near real-time via your favorite channels.

### How does the integration work?

Resmo uses API to do the initial polling and collect existing resources. Following the initial polling, it receives updates and changes in real-time through webhook and regular polling.

{% hint style="info" %}
**Tailscale API keys automatically expire after the chosen number of days.** You need to generate a new key once the one you used for the Resmo integration is expired.&#x20;

API keys can also be revoked before their expiration dates.
{% endhint %}

#### Available resources

{% embed url="<https://resources.resmo.com/tailscale>" %}

## Integration walkthrough

### How to install

1. Select Tailscale on the Integrations page.
2. Click the Add Integration button at the bottom right corner of the opening modal.
3. Log in to your Tailscale account on a new tab.
4. Go to [Personel Settings -> Keys](https://login.tailscale.com/admin/settings/keys) on your Tailscale account.

<figure><img src="/files/AEpEzdEaJRMaNOEPYWvP" alt=""><figcaption></figcaption></figure>

5. **Create and copy the API Key** from your Tailscale account by clicking the "Generate API Key..." button under the API keys.

<figure><img src="/files/ca1ncafWSJzsHeaOCSVH" alt=""><figcaption></figcaption></figure>

6. Paste it into the API Key field on the Resmo Tailscale integration setup page.
7. Click **Create**.
8. All set! Now you can start running queries on your Tailscale resources.

### How to uninstall

1. Select Tailscale on your Integrations page.
2. Navigate to the Connected Integrations tab on the opening modal.
3. Click the Tailscale integration you want to uninstall.
4. You have two options:

* To **temporarily pause** your Tailscale integration, click the **Disable button** from the top right of your integration Edit page. You can enable the integration back later.
* To **permanently remove** the integration, click the **Delete button**. This action cannot be undone.

<figure><img src="/files/HZYMtLoK4NXaxdOyJGXV" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://resmocom.gitbook.io/product/integrations/tailscale-integration.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.