VERDOCK

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#

  1. Download the wheel, SHA256SUMS and the signature. Do this on a connected machine. Save the files together in one folder.
  2. Carry them across on approved media. Use the media your security team has approved for moving files into the air gapped network.
  3. Check the files. Run sha256sum -c SHA256SUMS and verify the signature on SHA256SUMS with the published key. Stop if either check fails.
  4. Install without an index. Run pip install --no-index with the path to the wheel.
  5. Create a key for each approver. Run verdock keys create once per approver, on that approver's own machine or account. Each approver signs with their own key.
  6. Run the built in scene offline. Run verdock demo --offline. It blocks every socket call and ends with Network: 0 attempts.
  7. Verify. Run verdock verify on the receipts the scene wrote. Every receipt passes.
  8. Change one byte and see the failure. Copy the receipts file, change one character in the copy and run verdock verify on it. The verifier reports the broken line.

Commands#

Terminal
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_ROOT

Replace 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.