Galpi

Air-gapped install

Install and upgrade the Galpi server and its nodes without internet, with an offline bundle, a company mirror, or both.

Way When What Galpi gets
Offline bundle No internet at all OFFLINE=1, one bundle per Galpi version
Company mirror A Nexus, Artifactory or Harbor mirror exists MIRRORS=from=to …

They can be combined. Nodes look for anything in this order: what the node already has → the Galpi server's offline bundle → the company mirror → the internet (never with OFFLINE=1). Whatever the source, the SHA-256 is checked against a pinned value.

Air-gapped mode (OFFLINE=1)

With OFFLINE=1 Galpi connects to nothing outside the site. Features that need the outside switch off and say so ("off on an air-gapped network"). Blocked connections fail at once instead of timing out (EGALPIOFFLINE).

  • A gatekeeper is installed on the whole process as the server starts. Internet services Galpi knows (ipapi.co, Fly Sprites, OpenAI, Anthropic, GitHub, npm …) are blocked by name, without even asking DNS.
  • Other names are resolved with the site's DNS and blocked if any public address comes back. Loopback and private addresses pass.
  • Saving an outside address in the app (LLM, S3, OIDC …) is refused on the spot with the reason.
  • Use a company model server (an OpenAI- or Anthropic-compatible gateway) and manual certificates with company DNS.

Offline bundle

On a Linux (x86_64, Docker) machine with internet, collect everything Galpi uses into one .tar. One per Galpi version.

With internet (in the Galpi repository at the version the site will run)
node-kit/offline/build-bundle.sh --out /tmp/galpi-offline
#   --runtime e2b|sysbox|both   node runtimes to include
#   --vscode <commit>            VS Code server and CLI for the code editor
deploy/build.sh                                       # Galpi image
docker compose --profile git build forgejo-backup     # Forgejo backup image
deploy/offline-images.sh                              # Galpi, Caddy, Forgejo, versitygw, rclone images
At the site
docker load -i galpi-images-<id>.tar
docker volume create galpi_galpi-data
tar -xf galpi-offline-<id>.tar -C "$(docker volume inspect -f '{{.Mountpoint}}' galpi_galpi-data)"
# set OFFLINE=1, VM_CALLBACK_URL=node, manual certificates and the company CA in deploy/.env, then
docker compose up -d --no-build --pull never

A server without Docker installs it from the apt repository inside the bundle. Join nodes with the command in System admin → Nodes; they fetch their software from the bundle on the Galpi server.

Company mirror

MIRRORS is a list of from=to pairs (separated by spaces, commas or newlines). Addresses starting with from are fetched from to. Node installation and package installs inside VMs (npm, PyPI, Go, Docker) follow it.

bash
MIRRORS="https://registry.npmjs.org/=https://nexus.corp/repository/npm/ https://pypi.org/simple/=https://nexus.corp/repository/pypi/simple/"

Project package cache

To let npm ci or pip install work in a VM without internet, collect a project's dependencies on a connected machine and import them (deploy/project-dependencies.py). npm needs package-lock.json; Go needs go.mod and go.sum.

Full procedure

What has been verified and what hasn't, company CAs on nodes and VMs, and the upgrade order are in the Galpi repository's docs/폐쇄망.md.

Esc