> ## 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 deploy

## skyhook deploy

Deploy a service to an environment

### Synopsis

Deploy a service to a specific environment.

The command will infer the service from .koala.toml if in a service directory.
You can specify the target environment with --env or be prompted to select one.

Refs default to "main" for --config-ref and --ci-ref. When using -y (non-interactive),
all unspecified refs will use defaults without prompting.

```
skyhook deploy [flags]
```

### Examples

```
  skyhook deploy                      # Deploy current service (prompts for env)
  skyhook deploy --env prod           # Deploy to production
  skyhook deploy --service billing    # Deploy specific service
  skyhook deploy --env staging --build  # Build and deploy to staging
  skyhook deploy --env dev --build --code-ref feature/my-branch -y  # Non-interactive build+deploy
```

### Options

```
      --build               Build new image before deploying
      --ci-ref string       Git ref for CI workflow (default: main)
      --code-ref string     Git ref for code (branch/tag); defaults to current branch
      --config-ref string   Git ref for K8s config (default: main)
      --dry-run             Show what would be deployed without deploying
  -e, --env string          Target environment (e.g., dev, staging, prod)
  -h, --help                help for deploy
  -i, --interactive         Use the interactive multi-step form
  -s, --service string      Service to deploy
      --tag string          Image tag to deploy (for existing images)
  -y, --yes                 Skip all prompts and use defaults
```

### 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](/cli-reference/skyhook)	 - skyhook is a CLI tool to help you create and manage k8s services