Lucia

Lucia

Docker app from Lucia's Repository

Overview

Privacy-first Home Assistant agent platform with its dashboard and Wyoming voice server. Before installing, run `docker network create lucia` in the Unraid terminal, then install the Lucia PostgreSQL and Redis templates.

Readme

View on GitHub

Unraid Community Apps

Unraid requires one XML template per container. Lucia therefore ships three linked templates:

Install

Create the user-defined bridge network before installing any template. Each template selects it through <Network>lucia</Network>.

Run this once in the Unraid terminal:

docker network create lucia
mkdir -p /mnt/cache/appdata/lucia/postgres-init /mnt/cache/appdata/lucia/models
curl -fsSL https://raw.githubusercontent.com/seiggy/lucia-dotnet/master/infra/unraid/init.sql \
  -o /mnt/cache/appdata/lucia/postgres-init/init.sql
chown -R 1100:1100 /mnt/cache/appdata/lucia/models

If your cache pool is not named cache, change the template paths before installing.

Install the templates in this order:

  1. Lucia-PostgreSQL. Set a long database password containing only letters and numbers.
  2. Lucia-Redis.
  3. Lucia. Replace CHANGE_ME in all three PostgreSQL connection strings with the same database password.

Open http://<unraid-ip>:7233 and complete the setup wizard.

PostgreSQL reads init.sql only when its data directory is empty. To repair an existing installation that started without it, create the missing databases before starting Lucia:

docker exec Lucia-PostgreSQL createdb -U lucia luciaconfig
docker exec Lucia-PostgreSQL createdb -U lucia luciatraces
docker exec Lucia-PostgreSQL createdb -U lucia luciatasks

Install Lucia on Unraid in a few clicks.

Find Lucia in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for Lucia Review the template variables and paths Click Install
Explore Unraid OS

Requirements

Before installing, run `docker network create lucia` in the Unraid terminal. Install Lucia-PostgreSQL and Lucia-Redis first. The PostgreSQL password must match all three connection strings.

Categories

Home Automation

Download Statistics

17,918
Total Downloads

Related apps

Explore more like this

Explore all
Home Automation

Links

Projectluciahome.netSupportgithub.comDocker Hubhub.docker.comTemplateraw.githubusercontent.com

Details

Repository
seiggy/lucia-agenthost:latest
Registry
https://hub.docker.com/r/seiggy/lucia-agenthost
Last Updated2026-08-21
First Seen2026-08-26

Runtime arguments

Web UI
http://[IP]:[PORT:8080]/
Network
lucia
Shell
bash
Privileged
false
Extra Params
--restart=unless-stopped

Template configuration

Web UIPorttcp

Lucia dashboard and API.

Target
8080
Default
7233
WyomingPorttcp

Wyoming voice server.

Target
10400
Default
10400
ModelsPathrw

Downloaded speech and wake-word models. The container runs as UID 1100.

Target
/app/models
Default
/mnt/cache/appdata/lucia/models
EnvironmentVariable

ASP.NET Core environment.

Target
ASPNETCORE_ENVIRONMENT
Default
Production
Listen URLVariable

Internal HTTP listener.

Target
ASPNETCORE_URLS
Default
http://+:8080
Store providerVariable

Persistent store provider.

Target
DataProvider__Store
Default
PostgreSQL
Cache providerVariable

Cache provider.

Target
DataProvider__Cache
Default
Redis
Deployment modeVariable

Standalone runs all bundled agents in this container.

Target
Deployment__Mode
Default
standalone
Configuration databaseVariable

Replace CHANGE_ME with the Lucia-PostgreSQL password.

Target
ConnectionStrings__luciaconfig
Default
Host=Lucia-PostgreSQL;Port=5432;Database=luciaconfig;Username=lucia;Password=CHANGE_ME
Trace databaseVariable

Replace CHANGE_ME with the Lucia-PostgreSQL password.

Target
ConnectionStrings__luciatraces
Default
Host=Lucia-PostgreSQL;Port=5432;Database=luciatraces;Username=lucia;Password=CHANGE_ME
Task databaseVariable

Replace CHANGE_ME with the Lucia-PostgreSQL password.

Target
ConnectionStrings__luciatasks
Default
Host=Lucia-PostgreSQL;Port=5432;Database=luciatasks;Username=lucia;Password=CHANGE_ME
RedisVariable

Redis endpoint on the Lucia Docker network.

Target
ConnectionStrings__redis
Default
Lucia-Redis:6379
Dashboard API keyVariable

Optional fixed dashboard login key for headless setup.

Target
DASHBOARD_API_KEY
Home Assistant URLVariable

Optional Home Assistant URL for headless setup, such as http://192.168.1.100:8123.

Target
HOMEASSISTANT__BASEURL
Home Assistant tokenVariable

Optional Home Assistant long-lived access token for headless setup.

Target
HOMEASSISTANT__ACCESSTOKEN
Chat modelVariable

Optional headless model connection string: Endpoint=...;AccessKey=...;Model=...;Provider=...

Target
ConnectionStrings__chat-model
Embedding modelVariable

Optional embedding model connection string for semantic search.

Target
ConnectionStrings__embedding-model
SearXNG URLVariable

Optional SearXNG endpoint used by the web-search plugin.

Target
SEARXNG_URL
MetaMCP URLVariable

Optional MetaMCP endpoint.

Target
METAMCP_URL
MetaMCP API keyVariable

Optional MetaMCP API key.

Target
METAMCP_API_KEY
Observability modeVariable

Telemetry mode: Off, Metrics, Trace, or Profile.

Target
Observability__Mode
Default
Off
OTLP endpointVariable

Optional OpenTelemetry collector endpoint.

Target
OTEL_EXPORTER_OTLP_ENDPOINT
OTLP headersVariable

Optional OpenTelemetry exporter authentication headers.

Target
OTEL_EXPORTER_OTLP_HEADERS
TimezoneVariable

Container timezone.

Target
TZ
Default
Etc/UTC