SOP: Add Tailscale OAuth Secrets for GitHub Actions
Purpose
Configure repository secrets so the apply workflow authenticates to Tailscale using OAuth client credentials (preferred path).
Prerequisites
- Tailscale admin access for your tailnet
- GitHub repository admin/maintainer access on
syscode-labs/talos-arc-kvm-unraid
Steps
- Open Tailscale admin console OAuth page:
https://login.tailscale.com/admin/settings/oauth
- Create or select an OAuth client.
- Copy values:
- Client ID
- Client Secret
- Open GitHub repository secrets:
https://github.com/syscode-labs/talos-arc-kvm-unraid/settings/secrets/actions
- Add/update these repository secrets:
TAILSCALE_OAUTH_CLIENT_ID= Client IDTAILSCALE_OAUTH_SECRET= Client Secret
Validation
- Dispatch
applyworkflow with all ops disabled (no-op):run_terraform=falserun_arc_install=falserun_kvm_autoscaler_apply=false
- Confirm run succeeds.
- Dispatch
applywith the real operation you need and confirm tailnet connection succeeds.
Rollback/Recovery
- If OAuth credentials are invalid, rotate the OAuth client secret in Tailscale and update GitHub secret.
- Temporary fallback is
TAILSCALE_AUTHKEY, but OAuth should remain the target state.
Audit note
Record in your ops log:
- date/time
- operator
- OAuth client identifier used
- workflow run link for validation