Install & Compatibility
Where this runs
No compatibility data collected yet for this library.
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
tailscale
✓ import pulumi_tailscale as tailscale
✗ import tailscale
The module is named pulumi_tailscale, not tailscale
Provider
✓ from pulumi_tailscale import Provider
✗ from tailscale import Provider
Wrong import path
Creates a Tailnet key with the Tailscale provider.
import pulumi
import pulumi_tailscale as tailscale
# Requires TAILSCALE_API_KEY and TAILSCALE_TAILNET env vars
provider = tailscale.Provider(
"ts-provider",
api_key=os.environ.get('TAILSCALE_API_KEY', ''),
tailnet=os.environ.get('TAILSCALE_TAILNET', ''),
)
# Create a Tailnet key
tailnet_key = tailscale.TailnetKey(
"my-key",
reusable=False,
ephemeral=False,
preauthorized=True,
expiry_seconds=3600,
tags=["tag:prod"],
opts=pulumi.ResourceOptions(provider=provider),
)
pulumi.export("key", tailnet_key.key)
pulumi --version
Debug
Known issues
breakingIn v0.21.0, the `userId` input was removed from `oauthClient` resource and `nodeId` became required in `getDevicesDevice`. Check your stacks if upgrading from v0.20.x.fixRemove `userId` from OAuthClient definitions and ensure `nodeId` is set in device queries.
affects: >=0.21.0, <0.22.0
deprecatedThe `tailscale.Provider` resource is deprecated; use `pulumi.providers.tailscale.Provider` instead.fixReplace `from pulumi_tailscale import Provider` with `from pulumi_tailscale import Provider as TailscaleProvider` or switch to the new path.
affects: >=0.21.0
gotchaDo not import from `tailscale` directly. The correct module is `pulumi_tailscale`.fixUse `import pulumi_tailscale` or `from pulumi_tailscale import ...`
affects: all
Errors
Common errors & fixes
ModuleNotFoundError: No module named 'tailscale'
Importing the wrong module name.
fixUse `import pulumi_tailscale` instead of `import tailscale`.
pulumi.errors.ResourceError: resource '...' has a problem: expected 'userId' to be set
Using an older schema with `userId` on OAuthClient after v0.21.0 removed it.
fixRemove the `userId` argument from OAuthClient resource definition.
Upgrade
Version history
0.27.1latest on PyPI · released Apr 21, 2026
Audit
Dependencies
pulumirequiredPulumi SDK is required to use this provider