Skip to main content

Platform Architecture

RepoCloud provides two deployment models on shared infrastructure:
  • Container Apps — managed Docker containers deployed through a container orchestration platform. RepoCloud handles networking, SSL, scaling, and lifecycle management. You interact through the dashboard only.
  • VPS Apps — dedicated virtual private servers provisioned on bare-metal hosts. You get full root SSH access, a dedicated IPv4 address, and direct control over the operating system.
Both models share the same user dashboard, billing system, and support infrastructure.

Deployment Workflow

Container App Deployment

1

Select an Application

Browse the marketplace of 390+ pre-configured applications and click Deploy Now.
2

Configure

Name your project, choose autoscaling (the default) or a fixed resource tier, and fill in any app-specific settings. Most applications have sensible defaults.
3

Automated Provisioning

RepoCloud pulls the application’s Docker image, provisions a container with persistent storage, configures networking and SSL, and assigns an auto-generated HTTPS URL.
4

Ready

Your application is online in 3–7 minutes. The dashboard shows live deployment progress and transitions to the manage page automatically.

VPS App Deployment

1

Select a VPS Template or Use AI Deploy

Choose from 5 pre-configured VPS templates (Coolify, Dokploy, OpenClaw, Hermes Agent, Ubuntu VPS) or use AI Deploy for any GitHub repository.
2

Select a Tier

Pick a resource tier (starting at $6/month for VPS). Some apps have minimum requirements — for example, Coolify and Dokploy need at least 2 GB RAM.
3

Automated Provisioning

The control plane provisions a virtual machine, assigns a dedicated IPv4 address, installs the selected application, and configures SSH access with a generated root password and SSH key.
4

Ready

The VPS is online in 2–5 minutes. SSH credentials and the IPv4 address are displayed on the manage page.

AI Deploy Workflow

1

Paste a GitHub URL

Go to repocloud.io/ai-deploy and enter any public GitHub repository URL.
2

Select Tier and Start

Choose a resource tier and click Start Deployment. An AI agent takes over.
3

AI Configuration

The agent clones the repository, analyzes the codebase, provisions a VPS, installs dependencies, and configures the application. You can watch the process in a real-time chat interface.
4

Ready

Once deployment completes, the agent provides SSH credentials and the application URL. The VPS instance appears on your dashboard.

Management

All instances — Container Apps and VPS Apps — are managed from the same dashboard.

Dashboard Features

  • Live status indicators: real-time polling shows each instance’s current state (Deploying, Online, Paused, etc.)
  • Project tags: organize instances with custom tags
  • Search, sort, and filter: find instances by name, status, app, or tag
  • One-click actions: pause, delete, rename, and manage from the dashboard row

Container App Management

From the manage page:
  • Edit environment variables
  • Change the Docker image or tag (for version pinning or updates)
  • View application logs
  • Rebuild / update to the latest application version
  • Add a custom domain (CNAME-based with automatic SSL)
  • Resize to a different tier or switch to/from autoscaling

VPS App Management

From the manage page:
  • View SSH credentials (root password, SSH keys) and IPv4 address
  • Power on, power off, and reboot the server
  • Access a browser-based console (no SSH client needed)
  • Manage SSH keys
  • Reset the root password
  • Resize to a larger tier (disk cannot be shrunk)
  • Create, restore, and delete snapshots
  • Monitor CPU, RAM, disk, and bandwidth usage charts
  • Add a custom domain (A-record based)
  • Delete the instance

Billing

RepoCloud uses a prepaid credit system with hourly metering:
  • Hourly charges: resources are billed every hour based on your tier
  • Autoscaling (Container Apps): you pay only for the tier actually used each hour
  • Paused billing: paused instances are billed at 25% of the normal rate
  • Auto-recharge: optionally charge your card automatically when your balance drops below a threshold
  • VPS grace period: instances paused at zero balance have 15 days before automatic deletion
See Billing for complete details.

Elastic Hourly Autoscaling (Container Apps Only)

Container Apps deployed with autoscaling (the default) dynamically adjust resources based on usage:
  • Scales up instantly when your application needs more CPU, RAM, or storage
  • Scales down when demand drops
  • Bills only for the tier used each hour
  • No manual intervention required
Autoscaling is not available for VPS Apps — VPS instances run on fixed tiers and must be resized manually.

Next Steps

Technical Details

Hardware specs, networking, and resource tier details

Deployment Options

Compare all deployment methods

Dashboard

Learn the dashboard features

API / MCP

Deploy and manage instances programmatically