Infrastructure

Self-Hosting
Guide

Deploy Alpha PM on your own infrastructure. Full control, complete data sovereignty, enterprise-ready security.

Your Infrastructure
Slack App
GitHub App
Alpha PM Brain
DynamoDB
Memory
Runners

Requirements

What you need to run Alpha PM on your infrastructure

Compute

CPU 2+ vCPU
Memory 4GB+ RAM
Storage 20GB SSD

Services

Database DynamoDB
Vector Store Upstash
Container Docker/ECS

API Keys

Anthropic Required
GitHub App Required
Slack App Required

Quick Start

Get Alpha PM running in minutes

1
Clone the repository
bash 
git clone https://github.com/daverwin/alpha-pm.git
cd alpha-pm
2
Configure environment
bash 
cp .env.example .env
# Edit .env with your API keys and configuration
vim .env
3
Deploy infrastructure
bash 
cd aws/cdk
npm install
cdk deploy --all
4
Connect integrations
bash 
# Install Slack app to workspace
# Install GitHub app to repositories
# Configure webhook URLs in app settings

Deployment Options

Choose the infrastructure that fits your team

AWS (Recommended)

Full CDK stack for ECS Fargate deployment with all supporting infrastructure.

  • One-command deploy
  • Auto-scaling runners
  • Managed secrets
  • CloudWatch logging

Docker Compose

Simple local deployment for development and small teams.

  • Single machine deploy
  • Easy debugging
  • Local development
  • Quick iteration

Kubernetes

Helm charts for production Kubernetes clusters.

  • Horizontal scaling
  • Rolling updates
  • Service mesh ready
  • Multi-region support

Configuration

Essential environment variables for your deployment

.env
# AI Provider
ANTHROPIC_API_KEY=sk-ant-...
# Slack Integration
SLACK_BOT_TOKEN=xoxb-...
SLACK_APP_TOKEN=xapp-...
SLACK_SIGNING_SECRET=...
# GitHub Integration
GITHUB_APP_ID=123456
GITHUB_PRIVATE_KEY=-----BEGIN RSA...
GITHUB_WEBHOOK_SECRET=...
# Memory / Vector Store
UPSTASH_VECTOR_URL=https://...
UPSTASH_VECTOR_TOKEN=...

Support

Resources to help you deploy and operate Alpha PM

Documentation

Comprehensive guides and API reference

GitHub Issues

Report bugs and request features

Community

Join discussions and get help

Take Control

Deploy Alpha PM on your infrastructure. Your data, your rules, your autonomous PM.

View on GitHub Issue #293