Try describing what you need:

runtm logo

runtm

★ 302

A self-hosted alternative to Vercel Heroku

GNU Affero General Public License v3.0Open Source — No Paywall4 Containers — 4 containers — moderate hosting footprintPackage · Compose · SourceNeeds Postgres5 active committers (12mo)

About

Runtm is an open-source platform designed for coding agents that need isolated environments to build and deploy software. It provides sandboxed sessions where agents such as Claude Code, Cursor,...

Community Ratings

No ratings yet

Features

  • isolated sandboxes
  • live HTTPS deployments
  • logs and observability
  • multi-agent support
  • persistent workspaces
  • session start/list/attach/stop/destroy
  • templates
  • self-hosting
  • local sandbox sessions

Details

Last Updated
Oct 22, 2026
Created
Jan 2, 2026
Install Methods
package-managerdocker-composesource
Requirements
uvpipxpipGodocker compose
API
REST
Backup & Export
file-backup
Privacy & Independence
Cloud: Optional
Deployment

Deployment: Docker Compose ✓4 Containers — moderate hosting footprintRuns as 4 containers

Run runtm with Docker Compose

Compose file from the runtm project repository.

4 services · database: postgres · infra: postgres, redis

no resource limits declared

needs persistent storage (3 volumes)

infra/docker-compose.yml · @ 4284af1 · scanned Sep 23, 2026

version: "3.8"

services:
  api:
    build:
      context: ..
      dockerfile: infra/Dockerfile.api
    # Note: USER directive in Dockerfile handles non-root for production
    # For local dev, we don't override user to avoid volume permission issues
    ports:
      - "8000:8000"
    env_file:
      - ../.env  # Load from project root .env file
    environment:
      - DATABASE_URL=postgresql://runtm:runtm@postgres:5432/runtm
      - REDIS_URL=redis://redis:6379
      - API_SECRET=${RUNTM_API_SECRET:?Set RUNTM_API_SECRET environment variable}
      - ARTIFACT_STORAGE_PATH=/artifacts
      - ARTIFACT_STORAGE_BACKEND=local
      - AUTH_MODE=single_tenant
      - DEBUG=true
      # FLY_API_TOKEN and FLY_ORG are loaded from .env via env_file above
    volumes:
      - artifacts:/artifacts
    depends_on:
      postgres:
        condition: service_healthy
      redis:
        condition: service_started
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8000/health"]
      interval: 10s
      timeout: 5s
      retries: 5

  worker:
    build:
      context: ..
      dockerfile: infra/Dockerfile.worker
    # Note: USER directive in Dockerfile handles non-root for production
    # For local dev, we don't override user to avoid volume permission issues
    env_file:
      - ../.env  # Load from project root .env file
    environment:
      - DATABASE_URL=postgresql://runtm:runtm@postgres:5432/runtm
      - REDIS_URL=redis://redis:6379
      - API_SECRET=${RUNTM_API_SECRET:?Set RUNTM_API_SECRET environment variable}
      - FLY_ORG=${FLY_ORG:-personal}
      - ARTIFACT_STORAGE_PATH=/artifacts
      - ARTIFACT_STORAGE_BACKEND=local
      - USE_REMOTE_BUILDER=true
      - DEBUG=true
      # ALLOW_LOCAL_BUILDS is intentionally NOT set - forbidden in production
      # FLY_API_TOKEN is loaded from .env via env_file above
    volumes:
      - artifacts:/artifacts
      # SECURITY: Docker socket mount removed - use remote builder instead
    depends_on:
      postgres:
        condition: service_healthy
      redis:
        condition: service_started
      api:
        condition: service_healthy

  postgres:
    image: postgres:15-alpine
    environment:
      - POSTGRES_USER=runtm
      - POSTGRES_PASSWORD=runtm
      - POSTGRES_DB=runtm
    volumes:
      - pgdata:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U runtm"]
      interval: 5s
      timeout: 5s
      retries: 5
    ports:
      # SECURITY: Bind to localhost only - prevent external access
      - "127.0.0.1:5432:5432"

  redis:
    image: redis:7-alpine
    ports:
      # SECURITY: Bind to localhost only - prevent external access
      - "127.0.0.1:6379:6379"
    healthcheck:
      test: ["CMD", "redis-cli", "ping"]
      interval: 5s
      timeout: 5s
      retries: 5

volumes:
  artifacts:
    driver: local
  pgdata:
    driver: local


This file may be out of date. Check the runtm documentation for current setup steps.

Track your self-hosted stack

Bookmark software to try, rate tools you've used, and keep your collection in one place.

Metadata extracted from README on May 21, 2026

Related Software

Sim Studio logo

Sim Studio

29.9k
An open-source platform for building AI agents and orchestrating agentic workflows with integrations, LLMs, and vector databases.
Automation ToolsArtificial IntelligenceAI Tooling+4
Details
omnara logo

omnara

3.2k
Omnara is an open-source managed agent platform for running AI agents on any model and any machine, with built-in tools, secrets, permissions, and streaming.
AI AgentsAI ToolingPlatform as a Service+3
10 ContainersFully FOSS
Details
daytona logo

daytona

71.5k
Daytona is a secure infrastructure runtime for running AI-generated code and agent workflows in isolated sandboxes.
Artificial IntelligenceAI AgentsAI Tooling+2
Details
Olares logo

Olares

5.3k
Olares is an open-source personal cloud operating system for running and managing private services locally on your own hardware.
Self Hosting SolutionsPlatform as a ServiceLocal LLMs+3
2 Containers
Details
Langfuse logo

Langfuse

36.2k
Langfuse is an open source LLM engineering platform for teams to develop, monitor, evaluate, and debug AI applications.
IDE ToolsArtificial IntelligencePermissive License+5
6 ContainersFOSS with Issues
Details
Opik logo

Opik

22.8k
Opik is an open-source platform for observability, evaluation, monitoring, and optimization of LLM applications and agentic systems.
API ManagementArtificial IntelligenceAI Tooling+6
Details
open-terminal logo

open-terminal

3.4k
Open Terminal is a self-hosted terminal service for AI agents and automation tools that provides command execution, file management, and code running through a REST API.
Self Hosting SolutionsAutomation ToolsAI Agents+2
Details
n8n logo

n8n

208.4k
n8n is a fair-code platform for building and deploying AI agents and workflow automations, with a visual editor, custom code, and 1500+ integrations.
Automation ToolsPermissive LicenseLow Code Development+5
Single ContainerSource AvailableNot FOSS
Details
Flowise logo

Flowise

55.5k
Flowise is a visual tool for building AI agents.
Self Hosting SolutionsAI AgentsAI RAG Systems+3
Single Container
Details
Trigger.dev logo

Trigger.dev

16.6k
An open-source platform for building and deploying AI workflows and agents in TypeScript.
Task RunnersArtificial IntelligenceAutomation Tools+4
Details
Langflow logo

Langflow

155.9k
Langflow is a platform for building and deploying AI-powered agents and workflows with a visual builder, API deployment, and MCP server support.
Low Code DevelopmentAutomation ToolsModel Context Protocol+2
11 Containers
Details
Codex logo

Codex

130.5k
Codex CLI is a local coding agent from OpenAI that runs on your computer.
Artificial IntelligenceAI Coding AssistantPermissive License+3
Details