NOTE FOR MACINTOSH USERS, use these Simplified Instructions for Mac instead of this page
NOTE FOR LINUX OR WINDOWS USERS, we recommend you consult the Mac instructions if you run into issues with the instructions below.
Please note: We do not support direct development on Windows. If you are using a Windows machine, we recommend:
A. Install WSL
B. Set up your Windows machine as dual-boot with Linux
C. Setting up an Oracle VirtualBox and installing within that.
In our experience, a Windows machine should have 8 GB RAM (minimum), and you should allocate 2 CPUs and 4 GB RAM to the virtual machine.
1a. Installing PostgreSQL on Mac
1b. Installing PostgreSQL on Linux
3a. Install Python/Django on Mac
3b. Install Python/Django on Linux
Working with WeVoteServer day-to-day
You can build WeVoteServer as a Vagrant box using our Ansible-Vagrant project. Note that Ansible is straightforward to install on Mac and Linux hosts, but Windows isn't supported by Ansible. You may try to install via Cygwin, or for Windows 10 or later, install via the Windows 10 subsystem, at which point you should be able to proceed with the Ansible-Vagrant instructions.
Alternatively, you can try the prebuilt Vagrant box, which lets you avoid Ansible setup entirely. Using the prebuilt Vagrant box