ACE Deployment Guide

Deploy ACE in 5 minutes - PostgreSQL-only architecture for all tiers

PostgreSQL-Only Architecture

All tiers use client-provided PostgreSQL databases

You provide PostgreSQL: All tiers (Free, Pro, Enterprise) require a PostgreSQL database

Options: Neon (free tier recommended), local PostgreSQL, AWS RDS, Azure Database, Google Cloud SQL, Supabase

Auto-initialization: ACE creates the required schema automatically on first connection

💡 Free tier users: Use Neon's free tier (no credit card required) - perfect for getting started!

Deployment Options

Local Deployment

Run on localhost - perfect for development

Runs at http://localhost:7777

JWT authentication via ace login

PostgreSQL connection configured in ~/.ace/config.json

Perfect for solo development and testing

Quick Start:

# Install ACE (requires Node.js 18+)

npm install -g @ace3-memory/ace

# Login and configure

ace login

ace init

# Start server

ace start

Hosted Deployment

Deploy to production infrastructure

Deploy to any cloud (AWS, GCP, Azure) or on-premises

JWT authentication required

Configure SSL/HTTPS for production

Supports team collaboration and concurrent users

Deployment Steps:

# Install on server (requires Node.js 18+)

npm install -g @ace3-memory/ace

# Configure environment

export DATABASE_URL="postgresql://..."

# Start as service

ace start --port 7777

Subscription Tiers

Starter - Free

Try ACE risk-free

• 1 member, 1 namespace

• 100 memories, 50 API calls/day

• PostgreSQL (Neon free tier)

Developer - £9.99/mo

Serious hobbyists

• 1 member, 3 namespaces

• 2,500 memories, 500 API calls/day

• PostgreSQL (client-provided)

Pro - £24.99/mo

Small teams

• 10 members (+£3/extra)

• Unlimited memories & API calls

• PostgreSQL (client-provided)

Enterprise - Contact us

Large organizations (50+)

• 50+ members, unlimited everything

• PostgreSQL (client-provided)

• Dedicated support & SLA

PostgreSQL Setup

Get your PostgreSQL database configured

Recommended: Neon (Free Tier)

Visit neon.tech (no credit card required)
Create a new project
Copy your connection string
Configure during ace login or in ~/.ace/config.json

Connection string format: postgresql://user:password@host:5432/dbname

Other Options

Local PostgreSQL

Install PostgreSQL on your machine for development

AWS RDS

Managed PostgreSQL on AWS for production

Azure Database

Managed PostgreSQL on Azure

Supabase

Free tier available with generous limits