中文  |  English

Offline Installation

When the image registry is unreachable, download the offline bundle for your architecture and install on the target machine — no network required.

Prerequisites

• Docker
• Docker Compose
• root privileges (default install path /opt/databuff-ai-apm)

Download the Bundle

Download the all-in-one offline bundle matching your CPU architecture.

Recommended: pick a version and copy the download link on the install page under Docker → Offline Install.

Architecture	Bundle filename
amd64	databuff-ai-apm-offline-<version>-amd64.tar.gz
arm64	databuff-ai-apm-offline-<version>-arm64.tar.gz

Download URLs (replace <version> with the release, e.g. 0.1.2):

• amd64: https://openocta.com/pkg/databuff/<version>/offline/databuff-ai-apm-offline-<version>-amd64.tar.gz
• arm64: https://openocta.com/pkg/databuff/<version>/offline/databuff-ai-apm-offline-<version>-arm64.tar.gz

Example CLI download (amd64 / 0.1.2):

curl -fLO https://openocta.com/pkg/databuff/0.1.2/offline/databuff-ai-apm-offline-0.1.2-amd64.tar.gz

To resolve the latest release automatically, https://openocta.com/pkg/databuff/VERSION returns plain text (e.g. 0.1.2) — not the bundle. Query the version first, then download:

VERSION=$(curl -fsSL https://openocta.com/pkg/databuff/VERSION)
ARCH=amd64   # or arm64
curl -fLO "https://openocta.com/pkg/databuff/${VERSION}/offline/databuff-ai-apm-offline-${VERSION}-${ARCH}.tar.gz"

Each bundle includes deployment scripts, ai-apm-stack app images, and doris-stack infra images.

Install

Example for 0.1.2 / amd64 (download on a connected machine, then copy the bundle to the target):

tar -zxvf databuff-ai-apm-offline-0.1.2-amd64.tar.gz
cd databuff-ai-apm-offline-0.1.2-amd64

# Install platform
sudo ./install.sh

install.sh will:

1. Extract files to APM_INSTALL_DIR (default /opt/databuff-ai-apm)
2. docker load offline images (skips if present unless FORCE_LOAD_IMAGES=1)
3. Run start.sh (set SKIP_START=1 to install without starting)

The terminal prints Web UI URL, default credentials, and OTLP endpoints when done.

Install Demo (Optional)

sudo ./install_demo.sh

Environment Variables

Variable	Description
APM_INSTALL_DIR	Install path, default /opt/databuff-ai-apm
SKIP_START	1 = install only, do not start
FORCE_LOAD_IMAGES	1 = force docker load

vs Online Install

Online install uses ai-apm-install.sh to fetch the deploy bundle and per-arch image packages from CDN. Offline install does not require curl, CDN, or a registry — suitable for USB transfer or air-gapped sites.

Online one-liner (when network is available):

curl -fsSL https://databuff.ai/databuff/ai-apm-install.sh | bash

Recovery

Issue	Suggestion
docker load fails	Check disk space; retry with FORCE_LOAD_IMAGES=1
Start timeout	See logs in Docker Operations Reference
Upgrade version	Download the target offline bundle, extract, run update.sh (keeps data/); use install.sh only for fresh install

See Also

• Docker Installation
• Docker Operations Reference
• Upgrade and Uninstall