Platform Guide
We expect Bardolph to run well as a Python application on several popular operating system, including Linux (especially Raspberry Pi), Windows 11, and macOS.
This page contains information that is specific to each platform.
Note
If you don’t set up the Bardolph web server, you don’t really need to have Git on your system. However, it is a very popular tool, and we recommend that you have it available on your system.
Linux / Raspberry Pi
Running Bardolph on the default Raspberry Pi operating system is pretty much the same as running it on any standard version of Linux. Throughout this documentation, Raspberry Pi and other standard Linux distributions can be treated as equivalents.
Git
Git should be installed on your system. You can confirm by running this command:
git --version
If you don’t get a response telling you the version, you will need to install Git. You can do so through your system’s package manager. For more information, see https://git-scm.com/install/linux.
macOS
Command Line
The default command line app for macOS is Terminal, generally available in the Accessories folder under Commands. Other terminal emulator apps are also available, such as iTerm2: https://iterm2.com
Git
Git may be installed on your system. You can check by running this command:
git --version
If you don’t get a response telling you the version, you will need to install Git. You can do so through Homebrew or MacPorts, or by installing Xcode. For more information on all of these options, see https://git-scm.com/install/mac.
Windows
Python
With Windows, you will need to install Python. The recommended method is through the Micorosft Store (search for python).
Multiple options exist for installing Python on Windows, and a full treatment goes beyond the scope of this document. As a starting point, we recommend this article: https://realpython.com/installing-python/
Command Line
For Windows, the default is PowerShell running inside Windows Terminal. You can find more information about Windows Terminal here: https://learn.microsoft.com/en-us/windows/terminal/
Git
By default, Git is not installed with Windows. You can download it and read more about it at https://git-scm.com, the official site for Git.