---
title: "alpacon-common-action"
description: "Run any Alpacon CLI command in your CI/CD workflows. A flexible action for listing servers, checking status, managing groups, and other Alpacon operations."
---

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

# alpacon-common-action

Run any Alpacon CLI command in your workflow. Use this action for operations not covered by the specialized actions (websh, cp), such as listing servers, viewing events, or managing resources.

## Inputs

| Name | Description | Required | Default |
|------|-------------|----------|---------|
| `workspace-url` | Alpacon workspace URL | Yes | |
| `api-token` | Alpacon service token key (`alpst-`) | Yes | |
| `command` | Alpacon CLI command to execute (without `alpacon` prefix) | Yes | |

## Usage

### List servers

```yaml
- name: List all servers
  uses: alpacax/alpacon-common-action@v1
  with:
    workspace-url: ${{ secrets.ALPACON_WORKSPACE_URL }}
    api-token: ${{ secrets.ALPACON_SERVICE_TOKEN }}
    command: "server ls"
```

### List groups

```yaml
- name: List groups
  uses: alpacax/alpacon-common-action@v1
  with:
    workspace-url: ${{ secrets.ALPACON_WORKSPACE_URL }}
    api-token: ${{ secrets.ALPACON_SERVICE_TOKEN }}
    command: "group ls"
```

### View recent events

```yaml
- name: View recent events
  uses: alpacax/alpacon-common-action@v1
  with:
    workspace-url: ${{ secrets.ALPACON_WORKSPACE_URL }}
    api-token: ${{ secrets.ALPACON_SERVICE_TOKEN }}
    command: "event --tail=5"
```

## Notes

- Requires [`alpacon-setup-action`](/reference/actions/setup/) to run first
- The `command` input is appended to `alpacon`—do not include the `alpacon` prefix
- For remote command execution, prefer [`alpacon-websh-action`](/reference/actions/websh/)
- For file transfers, prefer [`alpacon-cp-action`](/reference/actions/cp/)

## See also

- [Actions reference overview](/reference/actions/)
- [alpacon-setup-action](/reference/actions/setup/)
- [alpacon-websh-action](/reference/actions/websh/)
- [alpacon-cp-action](/reference/actions/cp/)

## Resources

- [GitHub Marketplace](https://github.com/marketplace/actions/alpacon-common-action)
- [Source code](https://github.com/alpacax/alpacon-common-action)
- [CLI reference](/reference/cli/)

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