Skip to content

docs(readme): add airgapped deployment guidance - #109

Merged
arizon-dread merged 1 commit into
masterfrom
docs-airgapped-environment
Apr 9, 2026
Merged

arizon-dread merged 1 commit into
masterfrom
docs-airgapped-environment

Conversation

@davosian

@davosian davosian commented Apr 9, 2026

Copy link
Copy Markdown
Contributor

Summary

  • add a dedicated README section for running the image in airgapped environments
  • document that the bundled virus database age is tied to the image build time
  • explain practical offline update options for ClamAV signatures

Notes

  • the image runs freshclam during the Docker build, so the default signature set is only as current as the image build date
  • in a disconnected runtime environment, freshclam will not reach public mirrors unless an internal mirror is provided

Verification

  • documentation-only change
  • reviewed the existing Dockerfile and entrypoint behavior to align the README guidance with the current image behavior

@davosian davosian linked an issue Apr 9, 2026 that may be closed by this pull request
@github-actions

github-actions Bot commented Apr 9, 2026

Copy link
Copy Markdown

✅ Docker images built successfully for all platforms!

CI run: https://github.com/ajilach/clamav-rest/actions/runs/24195639432

@davosian
davosian marked this pull request as ready for review April 9, 2026 14:42
@davosian
davosian requested a review from arizon-dread April 9, 2026 14:42
@davosian

davosian commented Apr 9, 2026

Copy link
Copy Markdown
Contributor Author

@arizon-dread in my testing, the current version runs fine in an airgapped environment but of course no fresh virus definitions are pulled. Can you confirm the airgap mode? Do you see any improvement necessary to support this scenario? If not, I would go with the updated readme instructions for now, closing the long standing issue #34.

@arizon-dread

Copy link
Copy Markdown
Collaborator

I approved it based on your readme text which seems very reasonable to me. I can give this a spin tonight probably. I will retract my approval until I have verified.

@davosian
davosian requested a review from arizon-dread April 9, 2026 14:50
@davosian

davosian commented Apr 9, 2026

Copy link
Copy Markdown
Contributor Author

I approved it based on your readme text which seems very reasonable to me. I can give this a spin tonight probably. I will retract my approval until I have verified.

Thank you. I re-requested your approval so we can have a second opinion on this.

@arizon-dread arizon-dread left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I have now tried starting a freshly built image w/o internet access, aside from the errors from freshclam not being able to update the database, it works as it should. I have successfully scanned files from the same airgapped machine. I expect this to work also from a different machine inside the same airgapped network (non-internet access, but internal network access). I see the documentation as sufficient.

@arizon-dread
arizon-dread merged commit 7a88c89 into master Apr 9, 2026
6 checks passed
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.

Start Antivirus Service than check for Virus updates

2 participants

⌂ 换网址