---
title: "Actions reference"
description: "Reference documentation for Alpacon GitHub Actions. Four purpose-built actions for CI/CD workflows: setup, websh, cp, and common."
---

> Full documentation index: https://docs.alpacax.com/llms.txt

# Actions reference

Alpacon provides four GitHub Actions for CI/CD workflows.

  
    Install the Alpacon CLI in your workflow environment
  
  
    Execute shell commands on remote servers
  
  
    Copy files between local and remote servers
  
  
    Run any Alpacon CLI command
  

## Prerequisites

All actions except `alpacon-setup-action` require:
- An **Alpacon workspace URL** (e.g., `https://your-workspace.us1.alpacon.io`)
- A [**service token**](/use/iam/applications/service-tokens/) (its key starts with `alpst-`) with the scopes and ACL rules the workflow needs

Store these as [GitHub Actions secrets](https://docs.github.com/en/actions/security-for-github-actions/security-guides/using-secrets-in-github-actions) in your repository.

## Version policy

All actions follow semantic versioning. Use `@v1` to automatically receive backward-compatible updates:

```yaml
- uses: alpacax/alpacon-setup-action@v1
- uses: alpacax/alpacon-websh-action@v1
- uses: alpacax/alpacon-cp-action@v1
- uses: alpacax/alpacon-common-action@v1
```

For usage examples and workflow patterns, see [GitHub Actions integration](/integrate/github-actions/).

Source: https://docs.alpacax.com/reference/actions/
