explaingit

tailscale/gitops-acl-action

Analysis updated 2026-07-25 · repo last pushed 2026-07-20

146Audience · ops devopsComplexity · 2/5ActiveSetup · moderate

TLDR

A GitHub Action that manages your Tailscale network access rules through code. Push changes to GitHub and they automatically sync to your live network after review.

Mindmap

mindmap
  root((repo))
    What it does
      Syncs access rules
      Test mode on PRs
      Apply mode on merge
    How it works
      Policy file in repo
      GitHub Actions workflow
      Validates before applying
    Authentication
      API keys
      OAuth clients
      Federated identity
    Use cases
      Manage network as code
      Team review for changes
      Contractor access grants
    Audience
      DevOps teams
      Network admins
      Security-focused teams

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Manage who can access which servers in your Tailscale network by editing a file in GitHub instead of a dashboard.

USE CASE 2

Require team review before network access changes go live, catching mistakes before they affect production.

USE CASE 3

Grant a new contractor access to specific servers by opening a pull request and merging once approved.

What is it built with?

GitHub ActionsTailscale APIYAML

How does it compare?

tailscale/gitops-acl-actionadguardteam/adguardmv3awslabs/loom
Stars146146146
LanguageTypeScriptPython
Last pushed2026-07-202024-07-12
MaintenanceActiveDormant
Setup difficultymoderatemoderatehard
Complexity2/53/55/5
Audienceops devopsdeveloperops devops

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires a Tailscale account with API access and choosing an authentication method, API keys expire after 90 days so OAuth or federated identity is recommended for long-term use.

No license information is provided in the explanation, so the permissions for this project are unknown.

In plain English

Tailscale gitops-acl-action lets you manage your Tailscale network's access rules through a GitHub repository instead of a web dashboard. Tailscale is a tool that connects your devices into a private network, and it uses a policy file to control which devices and users can talk to each other. This action automatically syncs that policy file whenever you push changes to GitHub. The setup involves storing your policy file in a repo and configuring GitHub Actions to run on every push and pull request. When you open a pull request, the action runs in "test" mode, checking your changes for errors without actually applying them. When you merge to your main branch, it runs in "apply" mode, validating and then pushing the updated rules to your live Tailscale network. You authenticate using either an API key, an OAuth client, or a federated identity. This is useful for teams that want to treat their network configuration like code. Instead of one person clicking around a dashboard to change who can access what, changes go through the normal pull request workflow: someone proposes a change, a teammate reviews it, and automated checks catch mistakes before anything goes live. For example, if you want to grant a new contractor access to specific servers, you'd edit the policy file, open a PR, and merge it once approved. The project supports all three of Tailscale's authentication methods, though the README notes that API keys expire after 90 days and recommends using OAuth clients or federated identities for long-term setups. The federated identity approach is shown as the preferred option in the provided example, leveraging GitHub's built-in token system so you don't have to manage rotating credentials manually.

Copy-paste prompts

Prompt 1
Set up a GitHub Action workflow that uses tailscale/gitops-acl-action to sync my Tailscale policy file on every push to main, using federated identity for authentication.
Prompt 2
Configure tailscale/gitops-acl-action to run in test mode on pull requests so my team can review policy changes before they apply to the live network.
Prompt 3
Create a Tailscale policy file in my repo that grants a new contractor access to specific servers, and set up the gitops-acl-action to validate it on a PR before merging.
Prompt 4
Migrate my Tailscale network configuration from the web dashboard to a GitHub repository using gitops-acl-action with an OAuth client for long-term authentication.

Frequently asked questions

What is gitops-acl-action?

A GitHub Action that manages your Tailscale network access rules through code. Push changes to GitHub and they automatically sync to your live network after review.

Is gitops-acl-action actively maintained?

Active — commit in last 30 days (last push 2026-07-20).

What license does gitops-acl-action use?

No license information is provided in the explanation, so the permissions for this project are unknown.

How hard is gitops-acl-action to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is gitops-acl-action for?

Mainly ops devops.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.