> ## Documentation Index
> Fetch the complete documentation index at: https://docs.skyhook.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Skyhook github setup

## skyhook github setup

Set up GitHub Actions authentication with your cloud provider

### Synopsis

Configure OIDC trust between GitHub Actions and your cloud provider.

This enables GitHub Actions workflows to securely authenticate with AWS/GCP
without storing long-lived credentials. The setup creates:

AWS:  OIDC Identity Provider + IAM Role
GCP:  Workload Identity Federation + Service Account

The CLI can either:

1. Run cloud CLI commands directly (requires gcloud/aws CLI)
2. Generate a CloudFormation/Terraform template for manual deployment

Full documentation: [https://docs.skyhook.io/infrastructure/cicd-setup/github-oidc](https://docs.skyhook.io/infrastructure/cicd-setup/github-oidc)

```
skyhook github setup [flags]
```

### Examples

```
  skyhook github setup                       # Interactive setup
  skyhook github setup --cloud gcp           # GCP-specific setup
  skyhook github setup --template-only       # Generate template only
  skyhook github setup --github-org my-org   # Specify GitHub org explicitly
```

### Options

```
      --cloud string        Cloud provider (gcp, aws)
      --dry-run             Show what would be done
      --github-org string   GitHub organization (auto-detected from git remote)
  -h, --help                help for setup
      --repo string         GitHub repository for infrastructure (optional)
      --template-only       Generate template without executing
```

### Options inherited from parent commands

```
      --debug        Enable debug mode (shows full API requests/responses)
  -o, --org string   Organization name
  -v, --verbose      Enable user-friendly verbose output
```

### SEE ALSO

* [skyhook github](/cli-reference/skyhook_github)	 - Manage GitHub integration