Add config option for skipping docker pull before upgrading

CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 2025-01-06
+### Added
+- Add new config option for skipping docker pull before upgrading
+- Document config options for air-gapped setups
+
 ## 2024-11-18
 ### Added
 - When a custom `GIT_BRIDGE_IMAGE` is set, `bin/upgrade` no longer tries to pull the new version, and prompts

bin/upgrade

@@ -156,6 +156,7 @@ function handle_image_upgrade() {
     prompt "Are you following the recovery process?"
   fi
 
+  if [[ "${PULL_BEFORE_UPGRADE:-true}" == "true" ]]; then
     echo "Pulling new images"
     set_server_pro_image_name "$SEED_IMAGE_VERSION"
     docker pull "$IMAGE"
@@ -173,6 +174,7 @@ function handle_image_upgrade() {
       set_git_bridge_image_name "$SEED_IMAGE_VERSION"
       docker pull "$GIT_BRIDGE_IMAGE"
     fi
+  fi
 
   ## Offer to stop docker services
   local services_stopped="false"

doc/upgrading.md

@@ -16,3 +16,5 @@ If you do choose to switch versions, the script will then walk you through a pro
 The whole process looks like this:
 
 ![Demonstration of the upgrade script](./img/upgrade-demo.gif)
+
+> Note: For air-gapped setups that manually import docker images, please set `PULL_BEFORE_UPGRADE=false` in your `config/overleaf.rc` file.

lib/config-seed/overleaf.rc

@@ -41,3 +41,7 @@ NGINX_TLS_LISTEN_IP=127.0.1.1
 TLS_PRIVATE_KEY_PATH=config/nginx/certs/overleaf_key.pem
 TLS_CERTIFICATE_PATH=config/nginx/certs/overleaf_certificate.pem
 TLS_PORT=443
+
+# In Air-gapped setups, skip pulling images
+# PULL_BEFORE_UPGRADE=false
+# SIBLING_CONTAINERS_PULL=false