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

gb stop

Stop a running Genbox environment.

Synopsis

gb stop [name] [options]

Description

Pauses a running environment, preserving all data. Stopped environments don’t consume compute credits but still use storage.

Arguments

ArgumentDescription
nameOptional. Environment name. If not provided, stops current/default environment.

Options

OptionDescription
-y, --yesSkip confirmation prompt

Examples

# Stop specific environment gb stop feature-auth # Stop without confirmation gb stop feature-auth -y

What Gets Preserved

  • All file changes
  • Database data
  • Redis data (if persistent)
  • PM2 configurations
  • Environment variables

Cost Implications

StateCompute CostStorage Cost
RunningYes (by size)Yes
StoppedNoYes
DestroyedNoNo

When to Use Stop vs Destroy

Use stop when:

  • Taking a break but returning soon
  • Want to preserve database state
  • Working on multiple features

Use destroy when:

  • Completely done with the environment
  • Want to free all resources
  • Starting fresh

Notes

  • Stopped environments can be resumed with gb start
  • Storage costs are minimal but not zero
  • Consider gb destroy for unused environments

See Also

Last updated on