// DOWNLOAD

Download NeuraPBX

NeuraPBX ships as a self-hosted Docker Compose stack: the full PBX plus the AI engine. Pick the build for your processor, unzip, and docker compose up -d. The Free tier (5 extensions, core PBX) needs no license, and a 30-day trial unlocks 1 SIP trunk + full AI.

Self-hosted server

Desktop softphones

A native softphone for your computer: calling, transfers, and busy-lamp presence, connected to your NeuraPBX server.

Mobile apps

Your extension in your pocket: native calling, visual voicemail, and push notifications on iPhone and Android.

Quick start

1. Install Docker. What is Docker?A free, industry-standard tool that runs software in self-contained packages called containers. NeuraPBX ships as a set of containers (the phone engine, dashboard, AI and database, pre-assembled and tested together), so one command starts the whole system, nothing else gets installed on your server, and removing it later is just as clean.
   Check hardware requirements to size your server, then install Docker for your platform:
   Mac / Windows: install Docker Desktop and launch it once. On Windows it sets up WSL 2 for you. Accept the prompt and reboot if asked.
   Linux server: install Docker Engine + Compose with Docker's official script:

   # Debian / Ubuntu / RHEL / Fedora
   curl -fsSL https://get.docker.com | sh
   sudo usermod -aG docker $USER   # run docker without sudo (log out and back in once)
   docker compose version          # verify: should print v2.x

   Any recent Docker works. The bundle needs the docker compose v2 plugin, which ships with Docker Desktop and the script above.
2. Unzip and run the setup wizard. The x86 and ARM64 downloads are separate archives. Unzip whichever you downloaded, then let the wizard configure and start everything:

   # x86 (neurapbx-x86-*.zip): Mac/Linux
   cd neurapbx-deploy
   bash setup.sh
   
   # ARM64 / Apple Silicon (neurapbx-arm-*.zip)
   cd neurapbx-arm-deploy
   bash setup.sh
   
   # Windows: double-click setup.bat inside the extracted folder

   On Windows, right-click the zip → Extract All first (there's no built-in unzip). The wizard asks a few questions (ports, admin password), generates strong secrets, writes your .env, and starts the stack. A bare docker compose up -d on a fresh install stops with an error instead, because there are no secrets yet. After the first run, docker compose up -d is how you start it again. Every image ships inside the archive, so the first run loads them rather than downloading them. Give it a few minutes. If you enable a local AI model, that model is fetched on first use.
3. Open the dashboard. Visit http://localhost:8080 and sign in with the ADMIN_EMAIL / ADMIN_PASSWORD from .env. (The port is WEB_PORT in .env: 8080 unless you changed it.)
4. Register a phone. Point a softphone at your host's LAN IP on port 5060 (TCP recommended). On Apple Silicon, first set your Mac's LAN IP as described in the included README.md.