Linux / Debian

What you will do

Install the Debian package for your CPU architecture, configure Memory Layer, enable the backend service, and run health checks.

Before you start

Install PostgreSQL and pgvector first, or use a reachable PostgreSQL server with the vector extension enabled.

Release packages are published for:

• x86_64 Debian/Ubuntu: memory-layer_<version>_amd64.deb
• arm64 Debian/Ubuntu: memory-layer_<version>_arm64.deb

The arm64 package is the Raspberry Pi 4/5 path when the Pi runs a 64-bit Debian-family OS. 32-bit Raspberry Pi OS is not a release target yet.

Steps

# x86_64
sudo dpkg -i memory-layer_<version>_amd64.deb

# arm64 / Raspberry Pi 4/5 with a 64-bit OS
sudo dpkg -i memory-layer_<version>_arm64.deb

memory wizard --global
cd /path/to/project
memory wizard --dry-run
memory wizard
sudo systemctl enable --now memory-layer.service
memory doctor
memory health
memory tui

Use the release assets from GitHub for the package. If dpkg reports missing dependencies, install those packages with your normal package manager and rerun the package install.

Verify

memory --version
systemctl status memory-layer.service
memory status --project <project-slug>

Troubleshooting

• memory command not found: open a new shell or check the package install path.
• connection refused: verify the service is running and the configured port matches.
• extension "vector" is not available: install the pgvector package for your PostgreSQL major version.

Next

Read Service setup and Doctor and health.