Installation

CBSMembers is a desktop application. It connects to a shared PostgreSQL database on your server — multiple staff members can run it simultaneously on their own machines.

System requirements

The installer includes the .NET runtime — there is nothing else to install.

Step 1 — Download

Go to the Download page and download the package for your platform.

Step 2 — Install

Windows: run the installer (.exe). It will install CBSMembers and add a shortcut to the Start Menu and, optionally, your desktop.

Linux: extract the tarball and run the install script:

tar -xzf CBSMembers-*.tar.gz
cd CBSMembers-*
sudo ./install/install.sh

This copies the binary to /usr/local/bin and adds a launcher to your application menu. You can also run CBSMembers directly without installing: ./usr/bin/cbsmembers

macOS: open the .dmg, drag CBSMembers to your Applications folder. On first launch, right-click and choose Open if macOS shows a security warning.

Step 3 — Create your config file

Before you launch CBSMembers for the first time, you need to create a configuration file that tells it where your database is. See Configuration for the full details, including a step-by-step generator.

Windows tip: the AppData\Roaming folder is hidden by default. Type %AppData% into the Windows Explorer address bar and press Enter to go there directly.

Step 4 — Launch and log in

Open CBSMembers. You will be prompted to log in with an email address and password. These credentials must be set up in the database by your administrator before first use.

After five failed login attempts, the account is locked for 15 minutes.

Updating

Download and run the new installer (Windows) or tarball (Linux) over the top of the existing installation. Your config file is not affected.