Skip to main content

Hosted Sandboxes

A Hosted Sandbox is your personal slice of production-grade Kubernetes infrastructure - fully managed and running in under 2 minutes. Everything's centralized in a single pane of glass: infrastructure, configuration, monitoring, and TLS certificates. No hunting through repos or clusters for settings.

What is a Hosted Sandbox?

When you create a Codiac account and choose "Hosted Sandbox," the setup wizard automatically provisions:

  1. An enterprise - your organizational container
  2. An environment - a grouping for your cabinets
  3. A cluster agent - a per-tenant monitoring agent on the shared sandbox cluster
  4. A cabinet - your isolated runtime space (demo-cabinet)
  5. Six dev tools - production-ready services deployed, configured, and running
  6. Configurations - environment variables, ingress routes, and monitoring wired up

The entire process is automated. You watch a progress bar while Codiac builds your environment on real Kubernetes infrastructure.

Why Use a Sandbox?

Sandboxes are a great way to experience Codiac's capabilities - see how the platform manages real services, handles configuration, and organizes infrastructure. But they're also real infrastructure you can use for your needs right away:

  • Learn how Codiac works - see the platform in action with real services, not documentation
  • Run AI agents - give your agents a hosted environment with persistent services, reachable from anywhere
  • Extend your development environment - run processes and services that need to be accessible off your local machine
  • Prototype before production - test patterns and configurations before committing to infrastructure costs

Your sandbox runs on production-grade Kubernetes with enough resources to do meaningful work. Every service has a public HTTPS URL, so you can integrate with external tools, webhooks, and workflows.

Available Stacks

When you create a sandbox, you choose which stack to deploy. Each stack is tailored for a different use case:

Essentials Stack (Default)

A production-representative stack with databases, monitoring, and a sample API:

ServicePurposeWhy it's included
codiac-exampleSample web APISee a real application running on Codiac
PostgreSQLRelational databaseProduction-grade database backing the API
pgAdminDatabase management UIManage your database visually
GrafanaMonitoring dashboardsReal-time metrics and visualization
PrometheusMetrics collectionAutomatic metrics gathering from all services
RedisIn-memory data storeCaching and session management

Best for: Evaluating Codiac, understanding the platform, running typical web workloads.

AI Stack

An environment optimized for running AI agents and LLM-powered applications:

ServicePurposeWhy it's included
n8nWorkflow automationBuild and run AI agent workflows visually
PostgreSQLRelational databasePersistent storage for agent state and data
pgAdminDatabase management UIInspect and manage your data
QdrantVector databaseStore and query embeddings for RAG applications
RedisIn-memory data storeFast caching and message queuing

Best for: Running AI agents, building LLM applications, experimenting with RAG pipelines, automating workflows.


Every service in every stack is accessible, monitorable, and running on real containers - not a simulation.

How It Works

Isolation

Each sandbox is a completely isolated environment. Your services, configurations, and data are separate from other users - you can't see theirs, they can't see yours.

Monitoring

Your sandbox includes a dedicated monitoring agent that streams real-time status directly to your Codiac dashboard. You see:

  • Live service health (running, pending, failed)
  • Replica counts
  • Container restart counts
  • Version information

Networking

Every service gets a unique HTTPS URL with a TLS certificate. Grafana, pgAdmin, n8n, and your APIs are all reachable from your browser or any external tool.

Moving to Your Own Infrastructure

When you're ready to run on your own cloud, migrating is straightforward:

  1. codiac csp login - authenticate with your cloud provider (AWS or Azure)
  2. codiac cluster create - provision a cluster on your infrastructure
  3. codiac host map - configure your custom domain
  4. Drag and drop - move your cabinet to the new cluster in the UI, or use codiac snapshot deploy

Everything you configured in your sandbox - services, settings, structure - deploys to your infrastructure in minutes.

What You Can Do

Use your services freely

Once your stack deploys, every service gets a unique HTTPS URL with a TLS certificate generated for your tenant. Grafana, pgAdmin, and the example API are all live and accessible from your browser. This is a core Codiac feature - automatic ingress with TLS for every service, no manual certificate management.

These services are yours to use. Connect to your PostgreSQL instance via pgAdmin, build Grafana dashboards against your Prometheus metrics, hit the example API from Postman or curl - use them however you want.

Configure and redeploy

Update environment variables, feature flags, or any configuration on your assets, then redeploy. The service restarts with the new settings - no image rebuild required. This is Codiac's config-on-deploy in action: one image, many configurations.

You have complete freedom to modify, adjust, and experiment with your sandbox configuration. Every change is tracked and reversible.

Explore the platform

Click through the Codiac dashboard, inspect assets, view pod status, and understand how Codiac organizes infrastructure (enterprises, environments, cabinets, assets).

Understand the structure

Your sandbox gives you a concrete example of how Codiac organizes infrastructure:

  • Enterprise → top-level grouping
  • Environment → team/stage grouping (dev, staging, prod)
  • Cabinet → isolated runtime space within an environment
  • Asset → a deployed service

This same structure scales from your sandbox to multi-cloud enterprise deployments.

What You Can't Do (and Why)

Sandboxes run on a shared cluster, so deploying custom assets is restricted for security reasons. You can configure and redeploy the included services freely, but you cannot add your own container images to the sandbox environment.

This is by design - the sandbox is a great way to experience Codiac's capabilities, explore the platform, and use the included dev tools. When you're ready to deploy your own workloads, bring your own cloud. On your own clusters, you have full control to deploy whatever you choose.

Sandbox vs Your Own Cloud

FeatureSandboxYour Own Cloud
Dev tools & servicesFull access, configure freelyFull access
Custom assetsNot available (security)Deploy anything you want
InfrastructureShared clusterDedicated clusters
Unique URLs with TLSYesYes
Configuration changesFull freedomFull freedom
Custom domainsNot availableFull DNS support
Secrets managementPre-configuredCloud-native (AWS SM, Azure KV)
Cluster controlManaged by CodiacFull control
Zombie ModeNot applicableFull support
Multi-environmentSingle environmentUnlimited

Path to Production

Everything you build in your sandbox is production-portable. When you're ready to scale:

  1. Bring your own cloud - connect your AWS or Azure account
  2. Same configs, same structure - your enterprise, environments, cabinets, and asset definitions carry over
  3. Hand it to your SRE team - they inherit a clean, versioned, reproducible environment
  4. Unlock enterprise features - custom domains, secrets management, Zombie Mode, multi-environment promotion, cluster hopping

Your sandbox work isn't throwaway - it's the starting point for your production deployment.

See Sandbox to Production for the complete migration guide.

Coming Soon

Hosted Sandboxes are expanding. We're building toward turnkey hosted environments where teams can:

  • Spin up hosted IDEs accessible from anywhere
  • Access more developer tools without infrastructure overhead
  • Deploy sandboxes on your own cloud for tighter integration with your infrastructure
  • More stack options tailored for specific use cases

Sandboxes will be the starting point for everything - evaluate Codiac, run your agents, prototype your stack, hand off to production.

Get Started

  1. Go to codiac.io
  2. Click Try it free
  3. Choose Hosted Sandbox
  4. Watch your stack deploy

Two minutes. No credit card. No cloud account. No install.