Welcome to Sandock
Docker-based sandbox platform for AI agents and developers - secure, isolated code execution with SDK-first design
Welcome to Sandock 🚀
Sandock is a lightweight, cost-effective Docker-based sandbox platform that enables AI agents and developers to securely execute code, manage files, and run services in isolated containers.
New here? Start with Quick Start to get your first sandbox running in minutes!
The Problem: Isolation ≠ Complexity
Anyone can run code locally.
You can execute Python scripts, JavaScript code, or shell commands on your machine.
Almost nobody can safely execute untrusted code.
Security risks, environment conflicts, resource limits, and infrastructure complexity make it hard.
Sandock eliminates that gap.
What's Included
Sandock provides everything needed for secure, isolated code execution:
- ✅ Sandbox Lifecycle - Create, start, stop, and delete containers programmatically
- ✅ Code Execution - Run JavaScript, TypeScript, Python, and shell commands securely
- ✅ File System API - Read, write, list, and delete files within isolated workspaces
- ✅ Docker Integration - Lightweight Docker-based isolation (not heavy VMs)
- ✅ REST API - Hono + OpenAPI with automatic Swagger documentation
- ✅ Type-Safe SDKs - JavaScript/TypeScript and Python SDKs for easy integration
- ✅ Resource Limits - CPU, memory, and storage constraints per sandbox
- ✅ Real-time Monitoring - Track usage, logs, and performance metrics
Your AI agent becomes production-ready. Sandock handles the isolation.
Get Started
Quick Start
Get your first sandbox running in under 5 minutes
Sandbox Guide
Learn how to create and manage sandboxes
API Reference
Complete REST API documentation with examples
SDK Integration
Use JavaScript or Python SDKs in your applications
Deployment
Deploy Sandock to production environments
Troubleshooting
Common issues and solutions
Why Sandock?
🎨 Building Locally (Easy but Risky)
- Run code directly on your machine
- No isolation or security boundaries
- Environment conflicts between projects
- But... unsafe for untrusted code, no resource limits
🚀 Using Sandock (Secure & Simple)
- Isolated Docker containers for each execution
- Resource limits (CPU, memory, storage)
- No environment conflicts
- Launch sandboxes in seconds, execute code safely
Core Features
📦 Sandbox Lifecycle Management
Complete control over container lifecycle.
- Create sandboxes with specific resource limits
- Start/stop containers programmatically
- Auto-stop after inactivity to save costs
- List and monitor all active sandboxes
💻 Code Execution
Execute code safely in isolated environments.
- JavaScript/TypeScript - Run Node.js code with npm packages
- Python - Execute Python scripts with pip dependencies
- Shell Commands - Run bash commands with environment variables
- Real-time Output - Stream stdout/stderr as commands execute
📁 File System API
Manage files within isolated workspaces.
- Read and write files
- List directory contents
- Delete files and directories
- Execute files with executable permissions
🐳 Docker Integration
Lightweight container-based isolation.
- Docker-based (not heavy VMs like Firecracker)
- Fast startup (< 3 seconds vs 30+ for VMs)
- Configurable resource limits
- Support for custom Docker images
🌐 REST API + OpenAPI
Type-safe APIs with automatic documentation.
- Hono-based REST endpoints
- OpenAPI 3.0 specification
- Swagger UI at
/api/v1/doc - Consistent ResponseVO format
📚 SDK Support
Easy integration with your favorite languages.
- JavaScript/TypeScript - NPM package with full TypeScript types
- Python - Python SDK (or use requests directly)
- Simple API that abstracts HTTP calls
Use Cases
🤖 AI Agent Code Execution
Execute untrusted code safely for AI agents.
- Code interpreters for AI assistants
- Safe execution of user-generated code
- Resource limits to prevent abuse
- Real-time output streaming
🛠️ Development Environment Isolation
Run services in isolated containers.
- MCP (Model Context Protocol) server hosting
- VS Code Server instances
- Development tool isolation
- Multi-tenant environments
🎓 Educational Platforms
Safe code execution for online courses.
- Student code submission sandboxing
- Resource limits per student
- Auto-cleanup after sessions
- Scalable for hundreds of concurrent users
For Different Audiences
🤖 AI Agent Developers
Build agents that execute code safely.
- Sandbox Guide - Create and manage sandboxes
- SDK Integration - Use Sandock in your agent code
- API Reference - Complete API documentation
Start here: Quick Start →
👨💻 Backend Developers
Integrate Sandock into your applications.
- Quick Start - Set up in 5 minutes
- API Reference - REST endpoints with examples
- Deployment - Production deployment guide
Start here: Project Structure →
🚀 DevOps Engineers
Deploy and operate Sandock infrastructure.
- Deployment - Production deployment
- Troubleshooting - Common issues and solutions
- Project Structure - Understand the architecture
Start here: Deployment →
Popular Guides
Sandbox Lifecycle
Create, manage, and monitor sandboxes
Code Execution
Run JavaScript, Python, and shell commands
File Operations
Read, write, and manage files in sandboxes
SDK Usage
Integrate Sandock with JavaScript or Python
Deployment
Deploy to production environments
Troubleshooting
Common issues and how to fix them
Examples & Tutorials
Learn by doing with real-world examples:
- Create your first sandbox - Get started in 5 minutes
- Execute Python code - Run scripts with dependencies
- Manage files - Read and write files in sandboxes
- Integrate with AI agents - Use Sandock in your agent code
Community & Support
Need Help?
- 📖 Search these docs (press
Cmd+K) - 🐛 Report bugs
- 💬 Ask questions
- 📚 View examples
Stay Updated
- ⭐ Star on GitHub
- 📝 Check the Changelog
- 🚀 Follow for updates
Next Steps
Ready to get started?
- Quick Start - Set up in 5 minutes
- Create Your First Sandbox - Execute code safely
- Integrate with SDK - Use in your applications
Stop worrying about isolation. Start shipping secure code execution! 🚀