Swerp requires Python 3.6 or later to run.
Visit Python’s download page to download and install the latest version of Python 3 on your machine.
During installation, check Add Python 3 to PATH , then click Customize Installation and make sure that pip is checked.
Swerp uses PostgreSQL as database management system. Download and install PostgreSQL (supported version: 10.0 and later).
By default, the only user is
postgres but Swerp forbids connecting as
postgres, so you need to create a new PostgreSQL user:
- Add PostgreSQL’s
bindirectory (by default:
C:\Program Files\PostgreSQL\<version>\bin) to your
Create a postgres user with a password using the pg admin gui:
- Open pgAdmin.
- Double-click the server to create a connection.
- Select .
- Enter the username in the Role Name field (e.g.
- Open the Definition tab and enter the password (e.g.
swerp), then click Save.
- Open the Privileges tab and switch Can login? to
Yesand Create database?to
Before installing the dependencies, enable C++ compiler in your system.
Swerp dependencies are listed in the
file located at the root of the Swerp directory.
Navigate to the path of your Swerp installation (
) and run
on the requirements file in a terminal
with Administrator privileges
C:\>cd \SwerpPath C:\> pip install setuptools wheel C:\> pip install -r requirements.txt
For languages with right-to-left interface (such as Arabic or Hebrew), the package
- Download and install nodejs.
- Edit the System Environment’s variable
PATHto add the folder where
rtlcss.cmdis located (typically:
Once all dependencies are set up, Swerp can be launched by running swerp-bin, the command-line interface of the server. It is located at the root of the Swerp directory.
A typical way to run the server would be:
CommunityPath is the path of the Swerp Community installation,
dbuser is the PostgreSQL login,
dbpassword is the PostgreSQL password and
mydb is the default database to serve on
localhost:8069. You can add other directory paths separated by a comma to
addonsat the end of the addons-path option.