Skip to Content
🚀 APSO is now in public beta. Get started →

APSO Cloud

APSO Cloud is the fastest way to deploy your APSO backend. Get a production-ready API in minutes with automatic scaling, SSL, and monitoring.

Features

FeatureIncluded
Automatic SSLâś…
Auto-scalingâś…
Managed databaseâś…
Automatic backupsâś…
Monitoring & logsâś…
Custom domainsâś…
Preview environmentsâś…

Quick Start

1. Install CLI

npm install -g @apso/cli

2. Login

apso login

3. Deploy

apso deploy

Your API is now live at https://your-project.apso.cloud

Project Configuration

apso.config.json

{ "name": "my-api", "region": "us-east-1", "plan": "pro", "scaling": { "minInstances": 1, "maxInstances": 10 }, "database": { "size": "small" } }

Available Regions

RegionLocation
us-east-1Virginia, USA
us-west-2Oregon, USA
eu-west-1Ireland
eu-central-1Frankfurt
ap-southeast-1Singapore

Environment Variables

Via CLI

# Set a variable apso env set DATABASE_URL="postgresql://..." # Set multiple variables apso env set JWT_SECRET="secret" NODE_ENV="production" # List variables apso env list # Remove a variable apso env unset OLD_VARIABLE

Via Dashboard

  1. Go to your project in the APSO Dashboard
  2. Navigate to Settings → Environment Variables
  3. Add or edit variables
  4. Changes deploy automatically

Custom Domains

Add Domain

apso domains add api.yourdomain.com

Configure DNS

Add a CNAME record pointing to your APSO endpoint:

api.yourdomain.com → your-project.apso.cloud

SSL Certificate

SSL certificates are provisioned automatically via Let’s Encrypt.

Deployments

Manual Deploy

# Deploy current branch apso deploy # Deploy specific branch apso deploy --branch main # Deploy with message apso deploy -m "Add new feature"

Preview Environments

# Create preview for PR apso deploy --preview # Preview URL format # https://your-project-pr-123.apso.cloud

Rollback

# List recent deployments apso deployments list # Rollback to previous apso rollback # Rollback to specific deployment apso rollback d-abc123

Scaling

Automatic Scaling

APSO Cloud automatically scales based on traffic:

{ "scaling": { "minInstances": 1, "maxInstances": 10, "targetCPU": 70, "scaleUpThreshold": 80, "scaleDownThreshold": 30 } }

Manual Scaling

# Set minimum instances apso scale --min 2 # Set maximum instances apso scale --max 20

Database

Managed PostgreSQL

APSO Cloud includes managed PostgreSQL:

# View connection details apso db info # Connect via psql apso db connect # Run migrations apso db migrate # Create backup apso db backup # Restore from backup apso db restore backup-20240101

Database Sizes

SizeRAMStorageConnections
micro256MB1GB20
small1GB10GB50
medium4GB50GB100
large16GB200GB200

Monitoring

Logs

# Stream live logs apso logs # View recent logs apso logs --since 1h # Filter logs apso logs --level error

Metrics

Access via dashboard:

  • Request count and latency
  • Error rates
  • CPU and memory usage
  • Database connections
  • Response times by endpoint

Alerts

Configure alerts for:

  • High error rates
  • Slow response times
  • Resource exhaustion
  • Failed deployments

CI/CD Integration

GitHub Actions

# .github/workflows/deploy.yml name: Deploy to APSO Cloud on: push: branches: [main] jobs: deploy: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - name: Setup Node.js uses: actions/setup-node@v4 with: node-version: '20' - name: Install APSO CLI run: npm install -g @apso/cli - name: Deploy run: apso deploy --token ${{ secrets.APSO_TOKEN }}

Deploy Tokens

# Create deploy token apso tokens create --name "GitHub Actions" # Add to GitHub secrets as APSO_TOKEN

Pricing

PlanPriceFeatures
Free$0/mo1 project, 1M requests
Pro$25/moUnlimited projects, 10M requests
Team$100/moTeam features, 100M requests
EnterpriseCustomSLA, dedicated support
Last updated on