Skip to content

feat: Support offline Docker builds and image exports for air-gapped environments#2111

Open
wbg1991 wants to merge 1 commit intothingsboard:masterfrom
wbg1991:feat/offline-runtime
Open

feat: Support offline Docker builds and image exports for air-gapped environments#2111
wbg1991 wants to merge 1 commit intothingsboard:masterfrom
wbg1991:feat/offline-runtime

Conversation

@wbg1991
Copy link
Copy Markdown

@wbg1991 wbg1991 commented Mar 24, 2026

This PR introduces support for building and exporting Docker images designed specifically for air-gapped (closed-network) environments.

While the repository currently provides .deb installers for offline deployment, there is a growing demand for containerized deployments even in restricted environments for better orchestration and maintenance. This update bridge that gap by providing a native Docker-based offline workflow.

Changes:
New Dockerfile.offline: Uses requirements-full.txt instead of the standard requirements to pre-install all connector dependencies during the build stage.

.dockerignore Update: Modified to include requirements-full.txt in the build context so it can be accessed by the offline Dockerfile.

--offline Flag: Added to the build script to trigger the build using the offline-ready Dockerfile.

--save Flag: Added to allow users to export the built image directly into a .tar.gz archive, making it easy to transfer to servers without internet access.

Why this is needed:
In many enterprise or high-security production environments, direct internet access is prohibited. While .deb packages work, many modern infrastructures prefer Docker for consistency. These changes allow users to build a "heavy" image once in a networked environment and deploy it seamlessly in a fully offline environment.

- Added Dockerfile.offline to bundle all dependencies during build.
- Updated .dockerignore to include requirements-full.txt in build context.
- Introduced --offline flag for pre-installed dependency builds.
- Introduced --save flag to export images as tar.gz for restricted networks.
@CLAassistant
Copy link
Copy Markdown

CLAassistant commented Mar 24, 2026

CLA assistant check
All committers have signed the CLA.

@samson0v samson0v added this to the 3.8.4 milestone Mar 26, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants