From Whonix

< Dev


Developers only!

These are notes for producing official downloadable binary Whonix ™ images.

Pre Building[edit]

Only required if you want to redistribute (official) Whonix ™ builds.

Clean source code

  • [1]
  • [2]
  • You can get a list of unwanted files with git clean -dfxn and remove them with git clean -dfx.
  • Update Whonix ™ debian package repository.
  • add your own default-key to your own /home/user/.gnupg/gpg.conf.
  • Check that all packages point to a signed git commit and signed git tag.

~/Whonix/packages/whonix-developer-meta-files/debug-steps/packaging-helper-script pkg_verify_signed_commit_and_tag

  • push the source code to github

git push origin master

  • Check, that the current git commit is a signed. [3]

git log --show-signature HEAD^..HEAD

Or use the generic makefile as a shortcut.

make git-commit-verify

  • Create an OpenPGP signed git tag. This will also be used as Whonix ™ version number.

git tag -s version

  • Make sure the current git head is a signed git commit and signed git tag.

To simplify this, you could use the generic makefile.

make git-verify

  • Push the OpenPGP signed git tag to github.

git push origin version

  • Enable Whonix ™ stable repository by default.

export DERIVATIVE_APT_REPOSITORY_OPTS='--enable --repository stable'

  • And use sudo -E so above environment is kept.



Build Whonix-Gateway ™. For example Whonix-Gateway ™ with XFCE for VirtualBox.

sudo -E ./whonix_build --build --repo true --target virtualbox --flavor whonix-gateway-xfce

Build Whonix-Workstation ™. For example Whonix-Workstation ™ with XFCE for VirtualBox.

sudo -E ./whonix_build --build --repo true --target virtualbox --flavor whonix-workstation-xfce

For other options and platforms also see build documentation.

Post Building[edit]

Only required if you want to redistribute (official) Whonix ™ builds.

Image Signing

  • A) own custom builds: Optionally sign the images.
  • B) official Whonix ™ builds: Mandatory sign the images.
  • OpenPGP sign the images.

~/Whonix/packages/whonix-developer-meta-files/release/prepare_release --flavor whonix-workstation --target virtualbox --build

Only required if you want to redistribute (official) Whonix ™ builds.

  • Upload the images.



  • /usr/share/whonix-ws-firewall/unit_tests/stream_isolation_test

  • At least a few testers should test final releases before posting a news. Testers may be found by posting a news.
  • LeakTests!
  • Test the images before final release! (Testers-only releases can be uploaded straight away.)

Update Permanent Links[edit]

Update permalinks.

sudoedit /etc/nginx/conf.d/download_redirects

(ticket [archive])

Git Tag[edit]

Create -testers-only or -stable git tag.

Announcement Text Creation[edit]


./debug-steps/packaging-helper-script pkg_git_log_old_new

Testers-only and stable announcement.

./debug-steps/packaging-helper-script announcement

Wiki Page Updates[edit]

Only required if you want to redistribute (official) Whonix ™ builds.



Only required if you want to redistribute (official) Whonix ™ builds.




  • any deprecated repositories (none at time of writing)



  1. get rid of .directory files inside the source code: dolphinpreferencesgeneralbehavioruse common view properties for all folders
  2. Get rid of ~backup files. In other words, get rid of files starting with ~.
    find ./ -name '*~' | xargs trash-put

  3. You might wish using a git or bash alias to safe typing.

Fosshost is sponsors Kicksecure ™ stage server Whonix old logo.png
Fosshost About Advertisements

Search engines: YaCy | Qwant | ecosia | MetaGer | peekier | Whonix ™ Wiki

Follow: 1024px-Telegram 2019 Logo.svg.png Iconfinder Apple Mail 2697658.png Twitter.png Facebook.png Rss.png Reddit.jpg 200px-Mastodon Logotype (Simple).svg.png

Support: Discourse logo.png

Donate: Donate Bank Wire Paypal Bitcoin accepted here Monero accepted here Contriute

Whonix donate bitcoin.png Monero donate Whonix.png United Federation of Planets 1000px.png

Twitter-share-button.png Facebook-share-button.png Telegram-share.png Iconfinder Apple Mail 2697658.png Reddit.jpg 200px-Mastodon Logotype (Simple).svg.png

https link onion link Priority Support | Investors | Professional Support

Whonix | © ENCRYPTED SUPPORT LP | Heckert gnu.big.png Freedom Software / Osi standard logo 0.png Open Source (Why?)

The personal opinions of moderators or contributors to the Whonix ™ project do not represent the project as a whole.

By using our website, you acknowledge that you have read, understood and agreed to our Privacy Policy, Cookie Policy, Terms of Service, and E-Sign Consent.