Service Management

Services are the core unit in APSO. Each service represents a complete backend with its own database, API, and configuration.

Creating a Service

From Dashboard

1. Log in to app.apso.cloud 
2. Click + New Service
3. Choose a template:
   • Blank — Start from scratch
   • SaaS Starter — Multi-tenant with auth
   • API Only — Simple CRUD API
4. Enter details:
   • Name — Unique service identifier (lowercase, hyphens)
   • Description — Service description
   • Region — Deployment region
5. Click Create

From CLI

# Create a new service
apso server new my-service
 
# Create from template
apso server new my-service --template saas-starter
 
# Create and scaffold locally
apso server new my-service --scaffold

Service Configuration

General Settings

Navigate to Settings > General:

Schema Configuration

Navigate to Schema tab to edit your data model:

{
  "entities": {
    "Project": {
      "scoping": "organization",
      "fields": {
        "name": { "type": "string", "required": true },
        "status": { "type": "string", "enum": ["active", "archived"] }
      }
    }
  }
}

Changes to the schema trigger regeneration.

API Settings

Navigate to Settings > API:

Database Settings

Navigate to Settings > Database:

• Connection String — PostgreSQL connection URL
• Pool Size — Connection pool configuration
• SSL Mode — SSL/TLS settings

Deployment

Auto-Deploy

Services automatically deploy when:

• Schema changes are saved
• Environment variables are updated
• Manual deploy is triggered

Manual Deploy

From the dashboard:

1. Navigate to your service
2. Click Deploy button
3. Review changes
4. Confirm deployment

From CLI:

apso deploy

Deployment Status

Rollback

To rollback to a previous version:

1. Navigate to Deployments tab
2. Find the version to restore
3. Click Rollback
4. Confirm rollback

Service Status

Health Checks

APSO performs continuous health checks:

GET /health

Response:

{
  "status": "healthy",
  "database": "connected",
  "uptime": 3600,
  "version": "1.2.0"
}

Status Indicators

Starting and Stopping

Stop a Service

From dashboard:

1. Navigate to your service
2. Click Stop
3. Confirm action

Stopped services:

• Don’t accept requests
• Don’t incur compute charges
• Retain all data and configuration

Start a Service

From dashboard:

1. Navigate to your service
2. Click Start

Service will return to Running status within seconds.

Deleting a Service

Warning: Deleting a service is permanent and cannot be undone.

From Dashboard

1. Navigate to your service
2. Go to Settings > Danger Zone
3. Click Delete Service
4. Type the service name to confirm
5. Click Delete Forever

From CLI

apso service delete my-service --confirm

What Gets Deleted

• All generated code
• Database and all data
• Environment variables
• Deployment history
• API keys associated with the service

Cloning a Service

To create a copy of an existing service:

1. Navigate to the source service
2. Click Clone
3. Enter new service name
4. Choose what to clone:
   • Schema (always)
   • Environment variables (optional)
   • Database data (optional)
5. Click Create Clone

Service Limits

Related

• Dashboard Overview →
• Environment Variables →
• Deployment →