Skip to Content
New to Genbox? Check out our Getting Started guide
Introduction

Genbox CLI

AI-Powered Cloud Development Environments

Create isolated, fully-configured development environments in the cloud in minutes. Each environment gets its own server, database, and HTTPS URLs.

What is Genbox?

Genbox is a CLI tool that lets you spin up complete development environments in the cloud. Instead of running everything locally, you get:

  • Instant Environments - Fully-configured dev environments in minutes
  • Database Sync - Copy your staging/production database to your environment
  • HTTPS URLs - Each service gets a unique HTTPS URL
  • SSH Access - Direct SSH access to your environment
  • Auto-Destroy - Environments auto-cleanup when inactive (saves credits)

Quick Start

# Install the CLI
npm install -g genbox
 
# Login to your account
gb login
 
# Initialize your project
gb init
 
# Create a development environment
gb create feature-auth
 
# Check setup progress
gb status -w
 
# Connect via SSH
gb connect

Core Concepts

Environments (Genboxes)

A Genbox is a cloud-based development environment. Each Genbox includes:

  • A dedicated server (configurable size)
  • Your code repositories
  • Infrastructure services (MongoDB, Redis, etc.)
  • HTTPS endpoints for each service

Profiles

Profiles define different environment configurations:

  • quick - Just the frontend, connected to staging backend
  • full-stack - All apps running locally
  • api-only - Backend services only

Configuration

Projects are configured using a genbox.yaml file that defines:

  • Apps and their dependencies
  • Infrastructure requirements
  • Connection modes (local vs remote)
  • Database sync settings

Next Steps

Last updated on
Quick Start