3.2 Offline Installation

Offline installation is currently supported via Docker image deployment only. Air-gapped installation via source code or Windows installers is not yet supported.

3.2.1 Offline Installation Steps (Docker)

Use the following steps for offline installation:

1. Prepare and export the image on an internet-connected machine:

   docker pull ghcr.io/agentflocks/flocks:latest
   docker save ghcr.io/agentflocks/flocks:latest -o flocks-offline.tar

   If you are pulling images from mainland China, refer to Option 4: Docker Installation.

2. Copy flocks-offline.tar to the offline host.

3. Load the image on the offline host:

   docker load -i flocks-offline.tar

4. Start the service. The WebUI and API use the same service port:

   docker run -d \
     --name flocks \
     -e TZ=Asia/Shanghai \
     -p 5173:5173 \
     --shm-size 4gb \
     -v "${HOME}/.flocks:/home/flocks/.flocks" \
     ghcr.io/agentflocks/flocks:latest

After startup, access http://127.0.0.1:5173 locally. API requests are routed through the /api endpoint on the same host and port. You can also expose port 5173 to the internal or production network according to your network policy.

3.2.2 Related Documentation

After offline installation, check these pages first for common issues:

• Operations and Troubleshooting: service status, logs, tasks, and error recovery
• Scenario Supplement: Browser Automation Compatibility: image and automation integration details

If you have not performed offline installation and are doing a first online deployment, start with Installation and Quick Start.