Deploy

Azure Container Apps (recommended)

The hosted Plyra instance runs on Azure Container Apps in the Central India region. To run your own:

# 1. Build and push the image
docker build -t your-registry/plyra-memory-server:latest .
docker push your-registry/plyra-memory-server:latest

# 2. Create the container app
az containerapp create \
  --name plyra-memory-server \
  --resource-group your-rg \
  --image your-registry/plyra-memory-server:latest \
  --target-port 7700 \
  --ingress external \
  --secrets \
    admin-key=your_admin_key \
    groq-key=your_groq_key \
  --env-vars \
    PLYRA_ADMIN_API_KEY=secretref:admin-key \
    GROQ_API_KEY=secretref:groq-key

Environment variables

Variable	Required	Description
`PLYRA_ADMIN_API_KEY`	✅	Admin key for key management routes
`GROQ_API_KEY`	—	LLM extraction (Groq is preferred)
`ANTHROPIC_API_KEY`	—	Fallback LLM provider
`OPENAI_API_KEY`	—	Fallback LLM provider
`PLYRA_DATABASE_URL`	—	Postgres URL for multi-node deployments
`PLYRA_SERVER_PORT`	—	Default: 7700
`PLYRA_LOG_LEVEL`	—	Default: INFO

LLM provider priority

The server uses LLMs to extract structured facts from free-text memories. Provider priority:

Groq (GROQ_API_KEY) — preferred, fastest
Anthropic (ANTHROPIC_API_KEY) — fallback
OpenAI (OPENAI_API_KEY) — fallback
Regex — no LLM required, reduced extraction quality

Postgres (multi-node)

For deployments with multiple server instances, use Postgres instead of SQLite:

export PLYRA_DATABASE_URL=postgresql://user:pass@host:5432/plyra_memory

Health check

curl https://your-server/health
# → {"status": "ok", "version": "0.3.0"}

Always set PLYRA_ADMIN_API_KEY to a strong random value before deployment. The default is insecure and must be changed.

Getting started

Configuration

Reference

Azure Container Apps (recommended)

Environment variables

LLM provider priority

Postgres (multi-node)

Health check

​Azure Container Apps (recommended)

​Environment variables

​LLM provider priority

​Postgres (multi-node)

​Health check

Azure Container Apps (recommended)

Environment variables

LLM provider priority

Postgres (multi-node)

Health check