Versions and upgrades

you save a change  ──▶  a new version is created
                            │
                            ├──▶ every sandbox that starts from now on gets it
                            │
                            └──▶ Sandboxes already running: nothing happens
                                     │
                                     └──▶ they move only when you upgrade

​

Which version a sandbox uses

• A sandbox takes the latest version at the moment it starts.
• The sandbox keeps that exact version for the rest of its life.
• A save never changes a running sandbox.
• There is no automatic upgrade, no background rollout and no scheduled window.
• A sandbox moves only when you click Upgrade in the dashboard or run boat env upgrade.

​

Find the version of a sandbox

1. Run boat info <id>. It shows the version as environment and environmentVersion.
2. Run boat env list. It shows the latest version of each environment.
3. Compare the two numbers. A sandbox below the latest still runs the older configuration.

boat info bx_f7k2q9hd     # env:  prod (v2)
boat env list             # prod  latest v3   -> this sandbox is one upgrade behind

​

Upgrade