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.
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
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.
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.
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.
offline · without internet · no internet access · closed network · air-gapped