hackstrix/Portainer-Tailscale Deploy
Deploy Docker Compose stacks to a private Portainer instance via a secure Tailscale tunnel
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Stale
- License
- None
Inputs
| name | description | required | default |
|---|---|---|---|
| ts_oauth_client_id | Tailscale OAuth Client ID (recommended over ts_authkey) | no | — |
| ts_oauth_secret | Tailscale OAuth Client Secret | no | — |
| ts_authkey | Pre-generated Tailscale auth key (fallback if OAuth is not configured) | no | — |
| ts_tags | Comma-separated ACL tags for the ephemeral node (required for OAuth, e.g. tag:ci) | no | tag:ci |
| ts_hostname | Hostname for the ephemeral Tailscale node | no | "" |
| ts_connect_timeout | Seconds to wait for the Tailscale route to become available | no | 60 |
| portainer_url | Full Portainer URL including port (e.g. https://my-nas.tailnet.ts.net:9443) | yes | — |
| portainer_api_key | Portainer API key for authentication | yes | — |
| stack_name | Name of the Portainer stack to deploy | yes | — |
| compose_file | Path to the Docker Compose file | no | ./docker-compose.yml |
| endpoint_id | Portainer endpoint/environment ID (0 = auto-detect) | no | 0 |
| env_vars | Multiline KEY=VALUE environment variables (replaces all stack env vars) | no | "" |
| config_files | Multiline list of local_path:remote_path config files to upload alongside the compose file (applied on stack creation only) | no | "" |
| tls_skip_verify | Skip TLS certificate verification (for self-signed certs) | no | false |
| registry_url | Container registry URL (e.g. ghcr.io) — if set, configures credentials in Portainer | no | "" |
| registry_username | Registry username (e.g. your GitHub username for GHCR) | no | "" |
| registry_token | Registry password or access token | no | "" |
| action | Action to perform: deploy (create-or-update) or delete | no | deploy |
Outputs
| name | description |
|---|---|
| stack_id | The Portainer stack ID after deployment |
| stack_status | The final status of the stack (created, updated, deleted) |