Quick Start

Get ActionsManager running in under 5 minutes.

Table of contents
  1. Prerequisites
  2. Step 1: Start the Container
  3. Step 2: Open the Interface
  4. Step 3: Sign In
  5. Step 4: Create Your First Project
  6. Next Steps

Beta notice: ActionsManager Self-Hosted is currently a free beta preview for testing, evaluation, and feedback. No paid plans are currently available. The beta is provided as-is, without warranty or production-readiness guarantee.

Prerequisites

  • Docker 20.10+ or Podman 3.0+
  • Linux or macOS
  • 4 GB RAM (8 GB recommended)
  • 10 GB available disk space
  • A GitHub account with repositories to manage

Step 1: Start the Container

Run ActionsManager as a single self-hosted container on port 8080:

docker run -d \
  --name actions-manager \
  -p 8080:8080 \
  -v actions-manager-data:/app/backend \
  -e INSTALLATION_MODE=self-hosted \
  -e SECRET_KEY=$(openssl rand -hex 32) \
  -e REACT_APP_BACKEND_URL=http://localhost:8080 \
  -e REACT_APP_FRONTEND_URL=http://localhost:8080 \
  -e REACT_APP_WEBSOCKET_URL=ws://localhost:8080/ws \
  ghcr.io/turbo5000c/actions-manager/self-hosted:latest

Step 2: Open the Interface

Open http://localhost:8080 in your browser. You will see the ActionsManager sign-in page.

Step 3: Sign In

Choose one of the two authentication methods:

Option A — Personal Access Token (fastest):

  1. Click Sign in with Personal Access Token
  2. Paste a GitHub PAT with the required permissions (see PAT Setup)
  3. Click Sign In

Option B — GitHub OAuth:

  1. Create a GitHub OAuth App and configure it (see OAuth Setup)
  2. Pass the OAuth credentials as environment variables when starting the container
  3. Click Sign in with GitHub

Do not place a personal PAT in the Docker command line or shell history. Start the container first, then enter the token in the UI.

Step 4: Create Your First Project

  1. Click New Project in the dashboard
  2. Choose a project type:
    • Caller Workflow Project — manages repositories that call reusable workflows
    • Reusable Workflow Project — manages a shared workflow producer repository
  3. Add repositories to your project
  4. Explore workflow management features

Next Steps