Neuphlo · Self-hosting

Run Neuphlo on your own server.

Neuphlo is a shared workspace for people and AI that you can install on a host you operate. Keep control of your domain, mail delivery, backups, and updates.

View current release

Before you start

Bring a server and a domain.

Self-hosting is for operators comfortable with Docker, DNS, SMTP, and backups. You need Node.js 24, Docker Engine with Compose v2, a public domain pointing to this host, TCP ports 80 and 443, and UDP port 443. The installer sets up PostgreSQL, Neuphlo Server and Web, PowerSync, and Caddy for HTTPS.

This public installer needs internet access to download container images and obtain HTTPS certificates. For a fully isolated deployment, contact Neuphlo before setup. A Neuphlo administrator must enable air-gapped licensing for your billing workspace. The public bundle does not include a portable offline package.

Current release

Download the verified bundle.

The release bundle includes the installer, configuration, and full installation guide. Verify the archive checksum before unpacking it, then follow the guide's full bootstrap verification before running the installer.

Public release available · 1-7d0b8282578f9c4ef0ed
Download release bundle Download SHA-256 checksum

  1. Verify and unpack

    Save both files in the same directory, then run:

    sha256sum --check neuphlo-self-host-1-7d0b8282578f9c4ef0ed.tar.gz.sha256
mkdir neuphlo-bundle
tar -xzf neuphlo-self-host-1-7d0b8282578f9c4ef0ed.tar.gz -C neuphlo-bundle

  2. Read the included guide

    Open neuphlo-bundle/self-hosting.md and follow its bootstrap and setup steps. The bootstrap fetches the release again and checks every bundle file before you run the installer. The archive checksum above does not replace that step.

After installation

Choose when to update.

Updates are manual by default. The installed CLI can check the latest release, make a backup, update the services, and check their health. You can opt in to unattended updates with a host timer. Changes to sync rules pause for a manual authenticated sync check before the Web app changes.

Check for an update

node ~/.local/share/neuphlo/neuphlo.mjs update --check --latest

Install the update

node ~/.local/share/neuphlo/neuphlo.mjs update --latest

Check your installation

node ~/.local/share/neuphlo/neuphlo.mjs doctor

Keep encrypted off-host backups and rehearse restores. Application rollback is available, but database migrations and file contents are not rolled back automatically. The bundle guide explains backup, rollback, and optional automatic updates.