First Workflow Walkthrough

A screenshot walkthrough of the happy path for first-time Self-Hosted Beta users — from PAT sign-in to saving your first local workflow draft.

Table of contents
  1. Overview
  2. Step 1 — Open the Login Screen
  3. Step 2 — Enter Your PAT and Sign In
  4. Step 3 — Saved Projects Dashboard
  5. Step 4 — Create Project: Project Basics
  6. Step 5 — Create Project: Select Repositories
  7. Step 6 — Create Project: Review and Confirm
  8. Step 7 — Projects Dashboard After Creation
  9. Step 8 — Project Workspace: Overview
  10. Step 9 — Project Workspace: Add Your First Workflow
  11. Step 10 — Create New Workflow: Choose Type
  12. Step 11 — Regular Workflow Options
  13. Step 12 — Workflow Editor
  14. Step 13 — Saved Draft State
  15. What Happens Next
  16. Important Notes
    1. Saving a draft is not the same as pushing to GitHub
    2. PR-based delivery is recommended for beta testing
    3. Recommended PAT permissions
  17. Related Topics

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

Overview

This walkthrough covers the end-to-end happy path for a first-time self-hosted beta user:

  1. Open the login screen
  2. Enter your Personal Access Token and sign in
  3. View the empty Saved Projects dashboard
  4. Create a new project — Project Basics
  5. Create a new project — Select Repositories
  6. Create a new project — Review and confirm
  7. View the updated dashboard with your new project
  8. Open the project workspace
  9. Add your first workflow from the workspace
  10. Choose the workflow type
  11. Configure Regular Workflow options
  12. Review and edit workflow YAML in the editor
  13. Confirm the save-draft prompt
  14. View the saved draft state

Important: Saving a draft does not push any changes to GitHub. A saved draft exists only in ActionsManager until you create pull requests. PR-based delivery is the recommended path during beta testing.

Step 1 — Open the Login Screen

Open http://localhost:8080 after starting the container. The login screen offers two authentication methods: Sign in with GitHub (OAuth) and Sign in with Personal Access Token.

Login screen showing the PAT sign-in area alongside the GitHub OAuth option

For the fastest self-hosted beta path, choose Sign in with Personal Access Token and paste a fine-grained or classic GitHub PAT into the token field.

Never include a personal PAT in Docker command lines, shell history, environment files, GitHub issues, or screenshots. Enter the token in the UI after the container starts. See GitHub PAT Setup for recommended permissions.

Step 2 — Enter Your PAT and Sign In

Paste your PAT into the token field. The field will show the token ready for submission.

Login screen with a Personal Access Token entered in the token field, ready to sign in

Click Sign In to authenticate.

Step 3 — Saved Projects Dashboard

After signing in you land on the Saved Projects dashboard. The header shows beta usage limits (for example, 4 Caller Workflow Projects and 2 Reusable Workflow Projects in the Self-Hosted Beta). The project list is empty until you create your first project.

Saved Projects dashboard showing an empty project list, beta usage limits in the header, and the New Project button

Click New Project to begin.

Step 4 — Create Project: Project Basics

The Create Project wizard opens on the Project Basics step. Enter a project name, choose the project type, and pick an identity color.

Create Project — Project Basics showing project name field, Caller Workflow Project vs Reusable Workflow Project selection, and color picker

Option Description
Caller Workflow Project Manages repositories whose workflows call reusable workflows. This is the most common starting point.
Reusable Workflow Project Manages a shared workflow producer repository.

Choose Caller Workflow Project for a typical first project and click Next.

Step 5 — Create Project: Select Repositories

Select whether the project covers public or private repositories, then pick one or more repositories from the list. A summary of selected repositories is shown before you continue.

Create Project — Repository Visibility and Selection showing public/private toggle, repository selection list, and selected repository summary

Click Next when all target repositories are selected.

Step 6 — Create Project: Review and Confirm

Review the project summary before creation. This step also shows the Prefix Mode option.

Create Project — Resource Naming and Review showing Prefix Mode vs No Prefix Mode toggle and final project summary

Prefix Mode is enabled by default. It prefixes generated workflow filenames with a project-specific identifier, making it easy to distinguish ActionsManager-managed workflows from manually created ones. Keep Prefix Mode enabled unless you intentionally want unmanaged names.

Confirm the project name, type, repositories, and prefix setting, then click Create Project.

Step 7 — Projects Dashboard After Creation

After creating the project, you are returned to the Saved Projects dashboard. Your new project now appears in the project list with its identity color and type badge.

Saved Projects dashboard showing the newly created project in the project list with its identity color and type badge

Click the project card to open the project workspace.

Step 8 — Project Workspace: Overview

The project workspace opens with an empty workflow state. The left sidebar shows the project and its repositories.

Project workspace showing the project sidebar and the empty workflow state

Step 9 — Project Workspace: Add Your First Workflow

The main area shows three action buttons: Import Existing, Create Pull Requests, and Add Workflow.

Project workspace showing the Import Existing, Create Pull Requests, and Add Workflow action buttons

Click Add Workflow to create your first workflow.

Step 10 — Create New Workflow: Choose Type

The Create New Workflow modal presents three workflow type options:

Create New Workflow modal showing Regular Workflow, Reusable Workflow, and Link Reusable Workflow options

Option Description
Regular Workflow A standard GitHub Actions workflow file for one or more repositories in the project.
Reusable Workflow A workflow defined once and called from other workflows. Available for Reusable Workflow Projects.
Link Reusable Workflow Links this project’s caller workflows to an existing reusable workflow in another project.

Choose Regular Workflow for a first workflow and click Next.

Step 11 — Regular Workflow Options

Enter a workflow name and choose how to create the initial YAML content:

Regular Workflow Options modal showing workflow name entry and options: Open Blank Workflow, Detect Build Types, Generate Templates, and Generate with AI

Option Description
Open Blank Workflow Starts with an empty YAML editor.
Detect Build Types Inspects the selected repositories and recommends matching workflow templates based on detected build tooling (Maven, npm, .NET, Python, Go, Rust, Docker, etc.).
Generate Templates Presents a library of curated workflow templates.
Generate with AI Uses AI-assisted generation to create a workflow based on a natural-language description.

Enter a workflow name, choose an option, and click Create.

Step 12 — Workflow Editor

The workflow editor opens with the new workflow file. The header shows the generated filename (with prefix if Prefix Mode is enabled), the selected repository, and the current save state (Unsaved).

Workflow editor showing the generated prefix workflow filename, selected repository, YAML editor, Unsaved state indicator, and Commit Locally button

Review and edit the YAML as needed. When the workflow is ready to save locally, click Commit Locally.

Step 13 — Saved Draft State

After clicking Commit Locally, the workflow is saved immediately. The editor shows the New Local status badge and a toast notification confirms the workflow was saved as a draft.

Workflow editor showing the New Local status badge and a toast notification confirming the workflow was saved as a local draft

Saving a draft stores the workflow in ActionsManager only. It does not commit to a repository or push to GitHub. This is intentional — it lets you review and refine workflows before proposing changes through pull requests.

The workflow now exists as a local draft in ActionsManager. No changes have been made to any repository yet.

What Happens Next

Action Effect
Create Pull Requests Proposes the draft workflow to GitHub repositories as reviewable pull requests. Recommended for beta testing.
Continue editing Update the YAML and save additional drafts before creating pull requests.
Direct commit Commits directly to the repository branch without a pull request. Use carefully.

Return to the project workspace and click Create Pull Requests when you are ready to send the workflow to GitHub.

Important Notes

Saving a draft is not the same as pushing to GitHub

A Save draft / Commit Locally action stores the workflow in ActionsManager only. The workflow file does not appear in any repository until you explicitly create a pull request or use direct commit mode. Both are separate steps after drafting.

Pull request delivery lets you review each change before it merges. This is the safest path during beta. Direct commit mode is available but bypasses review; use it only when review overhead is not needed and the change is well understood.

When creating a fine-grained PAT for ActionsManager, grant these permissions to cover all features used in this walkthrough:

Permission Minimum Level Required for
Metadata Read-only All operations
Contents Read and write Workflow file management
Actions Read and write Workflow triggering
Pull requests Read and write PR-based delivery
Secrets Read and write Repository secrets management (optional)
Variables Read and write Repository variables management (optional)

Secrets and Variables permissions are only needed if you use those features. For a basic first-workflow walkthrough, Metadata, Contents, Actions, and Pull requests are sufficient.

See GitHub PAT Setup for full token creation instructions.