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

gb rebuild

Rebuild a Genbox environment with updated configuration.

Synopsis

gb rebuild [name] [options]

Description

Rebuilds an environment from scratch while preserving the database. Useful when configuration changes require a fresh setup.

Arguments

ArgumentDescription
nameOptional. Environment name.

Options

OptionDescription
--profile <name>Use different profile
--apps <list>Change included apps
--size <size>Change server size
--branch <name>Switch to different branch
--fresh-dbAlso reset database
-y, --yesSkip confirmation
-w, --watchWatch rebuild progress

Examples

Basic Rebuild

gb rebuild feature-auth

Change Configuration

# Switch to different profile gb rebuild feature-auth --profile full-stack # Add more apps gb rebuild feature-auth --apps admin,api,web # Upgrade server size gb rebuild feature-auth --size large

Switch Branch

# Rebuild with different branch gb rebuild feature-auth --branch develop

Fresh Database

# Rebuild and reset database gb rebuild feature-auth --fresh-db

What Gets Rebuilt

ComponentDefaultWith —fresh-db
ServerPreservedPreserved
CodeRe-clonedRe-cloned
DependenciesReinstalledReinstalled
DatabasePreservedReset
RedisClearedCleared

Use Cases

  • genbox.yaml changes: Apply new configuration
  • Dependency issues: Clean node_modules reinstall
  • Branch switching: Move to different branch
  • Size upgrade: Need more resources
  • Corrupted state: Fresh start with data

Rebuild vs Other Commands

CommandSpeedCodeDepsDB
restartFastSameSameSame
pushFastUpdatedSameSame
rebuildSlowFreshFreshSame
destroy + createSlowestFreshFreshFresh

Notes

  • Rebuild takes several minutes
  • Database is preserved by default
  • Use --fresh-db for complete reset
  • Watch mode shows detailed progress

See Also

Last updated on