---
id: pulumi-tailscale
version: "0.29.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# pulumi-tailscale — A Pulumi package for creating and managing Tailscale cloud resources.

License: permissive · Maintenance: active · Downloads: 425.0K/mo

## What it is and what it does

pulumi-tailscale is a Pulumi resource provider that bridges Tailscale's API into Pulumi's infrastructure-as-code framework. It lets you define Tailscale network resources—devices, users, DNS records, access control policies—declaratively in Python (or other Pulumi-supported languages) and manage them as part of a larger infrastructure stack. You write Python code using Pulumi's resource model, and the provider translates those declarations into Tailscale API calls.

The package depends on pulumi as its core framework, plus parver and semver for version handling, and typing-extensions for runtime type hints. It requires Python 3.9 or later and authentication via either a Tailscale API key or OAuth client credentials, both supplied through environment variables or Pulumi configuration. With no known vulnerabilities, active maintenance, and a permissive Apache-2.0 license, it's a straightforward addition to a Pulumi-based infrastructure workflow.

Use it for:

- Provision and manage Tailscale devices and network access as part of a larger infrastructure-as-code deployment.
- Automate DNS and access control policy updates across your Tailscale network using Pulumi stacks.
- Integrate Tailscale resource management into CI/CD pipelines that already use Pulumi for infrastructure.
- Define multi-environment Tailscale configurations (dev, staging, prod) in code and deploy them consistently.
- Track Tailscale network state in version control and collaborate on network changes via code review.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A Pulumi resource provider that lets you declare and manage Tailscale network resources—devices, users, DNS settings, and access controls—as infrastructure code.

Yes, if you use Pulumi for infrastructure and need to manage Tailscale resources programmatically. The package is actively maintained, has low install friction, carries no known vulnerabilities, and uses a permissive license. Install it as a standard Pulumi provider dependency when your infrastructure code needs to declare or update Tailscale network resources.

## Install

pip install pulumi-tailscale
uv add pulumi-tailscale
poetry add pulumi-tailscale

## Installing pulumi-tailscale

Before you install: Low friction: pure Python wheel with four lightweight runtime dependencies (parver, pulumi, semver, typing-extensions). Actively maintained with a recent release 32 days ago and no known vulnerabilities.

License in practice: Apache-2.0 is permissive: you can use, modify, and distribute this package freely in commercial and private projects, with minimal obligations beyond retaining the license notice.

Quickstart:

pip install pulumi_tailscale

import pulumi
import pulumi_tailscale as tailscale

# Requires TAILSCALE_API_KEY and TAILSCALE_TAILNET environment variables
device = tailscale.Device("my-device", ...)

Requires Python >=3.9 and Tailscale API credentials (API key or OAuth client credentials) set via environment variables or Pulumi config.

Verify before relying:

- Exact list of Tailscale resource types (devices, users, DNS, ACLs, etc.) supported by version 0.29.0.
- Whether this provider supports all Tailscale API features or a subset; scope of coverage relative to the full Tailscale API.
- Performance characteristics or limits when managing large numbers of Tailscale resources.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 425.0K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

pulumi tailscale provider, infrastructure as code tailscale, manage tailscale networks programmatically, tailscale resource provider, pulumi tailscale resources, declare tailscale infrastructure, tailscale iac, pulumi network management, infrastructure-as-code, pulumi-provider, network-management

[View on SkillFed](https://skillfed.io/packages/pulumi-tailscale) · [View on PyPI](https://pypi.org/project/pulumi-tailscale/)