Offline install
Install Verdock on a machine with no internet access and check that the files are the ones we published. Eight steps.
On this page
Use this guide when the target machine cannot reach the internet. You download on a connected machine, carry the files across on approved media, check them and install without an index.
The eight steps#
- Download the wheel, SHA256SUMS and the signature. Do this on a connected machine. Save the files together in one folder.
- Carry them across on approved media. Use the media your security team has approved for moving files into the air gapped network.
- Check the files. Run
sha256sum -c SHA256SUMSand verify the signature on SHA256SUMS with the published key. Stop if either check fails. - Install without an index. Run
pip install --no-indexwith the path to the wheel. - Create a key for each approver. Run
verdock keys createonce per approver, on that approver's own machine or account. Each approver signs with their own key. - Run the built in scene offline. Run
verdock demo --offline. It blocks every socket call and ends withNetwork: 0 attempts. - Verify. Run
verdock verifyon the receipts the scene wrote. Every receipt passes. - Change one byte and see the failure. Copy the receipts file, change one character in the copy and run
verdock verifyon it. The verifier reports the broken line.
Commands#
sha256sum -c SHA256SUMS
pip install --no-index ./verdock-VERSION-py3-none-any.whl
verdock keys create junior
verdock demo --scene all --offline --out run
verdock verify run/receipts-payout.ndjson --public-key ENGINE_PUBLIC_KEY --manifest-root MANIFEST_ROOTReplace VERSION with the version in the file name you downloaded. --out run keeps the receipt logs and a trust.json that holds the public keys, so you can verify without running the scene again.
Licence and usage offline#
Licence and usage counting work offline too. See online and offline usage for how offline usage is counted, and the data policy for what leaves a connected install.