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
| Argument | Description |
|---|---|
name | Optional. Environment name. |
Options
| Option | Description |
|---|---|
--profile <name> | Use different profile |
--apps <list> | Change included apps |
--size <size> | Change server size |
--branch <name> | Switch to different branch |
--fresh-db | Also reset database |
-y, --yes | Skip confirmation |
-w, --watch | Watch rebuild progress |
Examples
Basic Rebuild
gb rebuild feature-authChange 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 largeSwitch Branch
# Rebuild with different branch
gb rebuild feature-auth --branch developFresh Database
# Rebuild and reset database
gb rebuild feature-auth --fresh-dbWhat Gets Rebuilt
| Component | Default | With —fresh-db |
|---|---|---|
| Server | Preserved | Preserved |
| Code | Re-cloned | Re-cloned |
| Dependencies | Reinstalled | Reinstalled |
| Database | Preserved | Reset |
| Redis | Cleared | Cleared |
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
| Command | Speed | Code | Deps | DB |
|---|---|---|---|---|
restart | Fast | Same | Same | Same |
push | Fast | Updated | Same | Same |
rebuild | Slow | Fresh | Fresh | Same |
destroy + create | Slowest | Fresh | Fresh | Fresh |
Notes
- Rebuild takes several minutes
- Database is preserved by default
- Use
--fresh-dbfor complete reset - Watch mode shows detailed progress
See Also
gb restart- Quick restartgb push- Push code changesgb create- Create new environment
Last updated on