Installation Guides

Getting Started with PharmaPOS

Follow the step-by-step guide for your platform to get up and running in minutes.

Windows Windows 10 / 11 Installation

1
Download the installer

Go to the Download page and click Download for Windows to get the .exe installer file.

2
Run the installer

Double-click PharmaPOS-Setup-1.0.0.exe. If Windows Defender SmartScreen appears, click "More info" → "Run anyway".

3
Choose install location

The installer lets you choose a custom installation directory. The default is C:\Program Files\PharmaPOS. Click Install.

4
Launch PharmaPOS

After installation, a Desktop shortcut is created automatically. Double-click it to launch. Log in with your pharmacy credentials.

Note: An internet connection is required to connect to the PharmaPOS API backend. The app will not work in fully offline environments.

macOS macOS Installation (DMG)

1
Download the DMG

Click Download for macOS on the Download page. Your browser will download PharmaPOS-1.0.0.dmg.

2
Open the DMG

Double-click the downloaded .dmg file. A Finder window opens showing the PharmaPOS app icon.

3
Drag to Applications

Drag the PharmaPOS icon to the Applications folder shortcut in the DMG window.

4
First launch — allow Gatekeeper

Right-click PharmaPOS.app in Applications → Open. Click Open again on the Gatekeeper dialog. This is only needed once.

Apple Silicon: The DMG is universal — it runs natively on both Intel and Apple Silicon (M1/M2/M3) Macs. Requires macOS 11 Big Sur or later.

Linux Ubuntu — AppImage (Portable)

1
Download the AppImage

Download PharmaPOS-1.0.0.AppImage from the Download page.

2
Make it executable

Open a terminal in the download folder and run: chmod +x PharmaPOS-1.0.0.AppImage

3
Run the app

Double-click the AppImage file, or run: ./PharmaPOS-1.0.0.AppImage --no-sandbox

Tip: On some Ubuntu systems you may need to install FUSE: sudo apt install libfuse2

Linux Ubuntu — .deb Package Installation

1
Download the .deb package

Download pharmapos_1.0.0_amd64.deb from the Download page.

2
Install with dpkg

Open a terminal and run: sudo dpkg -i pharmapos_1.0.0_amd64.deb

3
Fix any dependencies

If you see dependency errors, run: sudo apt --fix-broken install

4
Launch from Applications

PharmaPOS will appear in your Applications menu. You can also run it from the terminal as: pharmapos --no-sandbox

Tested on: Ubuntu 20.04 LTS, Ubuntu 22.04 LTS, Ubuntu 24.04 LTS, Linux Mint 21.

Web Using the Web Application (No Install Required)

1
Open your browser

The PharmaPOS web app works in any modern browser (Chrome, Firefox, Edge, Safari). No installation needed.

2
Navigate to the web app

Go to: pharmacy.devke.co.ke

3
Log in with your credentials

Use the username and password provided by your pharmacy administrator. The first time, a SuperAdmin creates your pharmacy and assigns you an account.