#pragma section-numbers 2

= Building  Packages =

Documentation of how to build packages for various platforms.

<<TableOfContents>>

== .deb-based distros ==

Use Docker, and run {{{make docker-{debian,ubuntu}-$RELEASE}}} eg {{{make docker-debian-buster}}} or  {{{make docker-ubuntu-xenial}}}. If a release codename is missing you may need to edit (and preferably [[ContributingChanges|send us a patch]]) {{{Makefile}}} to add the new release.

== .rpm-based distros ==

Use docker, and run {{{make docker-fedoraN}}} or {{{make docker-centosN}}} as appropriate for your release, eg {{{make docker-fedora30}}} or {{{make docker-centos8}}}.  As with debian distros, please feel encouraged to add missing releases as needed to the {{{Makefile}}}.

== macOS ==

Requires a Mac with Xcode installed. Run {{{make osx}}} and an installer package will be built.

== Windows ==

On a fresh system, the PowerShell script `contrib/install-windows-dependencies.ps1` can be used to download the required dependencies.

Open an MSVC++ 2008 or MSVC++ Compiler Package for Python 2.7 command prompt, and navigate to the root of the repository.  The 32-bit command prompt builds 32-bit installers; the 64-bit command prompt builds 64-bit installers.

=== Inno ===

{{{
py -3 contrib\packaging\packaging.py inno --python C:\Python27\python.exe
}}}

=== WiX ===

{{{
py -3 contrib\packaging\packaging.py wix --python C:\Python27\python.exe
}}}

Windows build [[BuildingWindowsInstaller|legacy instructions]].

----
## list categories here