Weavestream Worker
| Description / name | Input element |
|---|---|
| Container Registry |
Background queue worker and scheduled task runner for Weavestream, an open-source self-hosted IT documentation and asset management platform.
| Registry | ghcr.io/daemonless/weavestream-worker |
| Daemonless | daemonless/weavestream-worker |
| Source | Weavestream/Weavestream |
| Website | weavestream.io |
Version Tags
| Tag | Description | Best For |
|---|---|---|
latest |
FreeBSD Port. Built from latest FreeBSD packages. | Most users — recommended. |
Before deploying, ensure your host environment is ready. See the Quick Start Guide for host setup instructions, including the security model for host vs. container privileges.
Interactive Configuration
Parameters
Environment Variables
| Variable | Default | Description |
|---|---|---|
PUID |
1000 |
User ID for the worker process |
PGID |
1000 |
Group ID for the worker process |
TZ |
UTC |
Timezone for the container |
DATABASE_URL |
postgresql://weavestream:REPLACEME@postgres:5432/weavestream |
PostgreSQL connection string (e.g. postgresql://user:pass@host:5432/db) |
REDIS_URL |
redis://:REPLACEME@redis:6379/0 |
Redis or Valkey connection string (e.g. redis://host:6379/0) |
APP_URL |
http://localhost:3000 |
Public origin of the web UI (default: http://localhost:3000) |
API_URL |
http://localhost:3000/api |
Public origin of the API (default: http://localhost:3000/api) |
JWT_SIGNING_KEY |
REPLACEME_32_BYTES_BASE64 |
32-byte base64 secret, the same in api and worker |
MFA_ENCRYPTION_KEY |
REPLACEME_32_BYTES_BASE64 |
32-byte base64 secret, the same in api and worker |
PASSWORD_ENCRYPTION_KEY |
REPLACEME_32_BYTES_BASE64 |
32-byte base64 secret, the same in api and worker |
INTEGRATION_SECRET_KEY |
REPLACEME_32_BYTES_BASE64 |
32-byte base64 secret, the same in api and worker |
SMTP_SECRET_KEY |
REPLACEME_32_BYTES_BASE64 |
32-byte base64 secret, the same in api and worker |
COOKIE_SIGNING_KEY |
REPLACEME_32_BYTES_BASE64 |
32-byte base64 secret, the same in api, worker and web |
CSRF_SIGNING_KEY |
REPLACEME_32_BYTES_BASE64 |
32-byte base64 secret, the same in api and worker |
FILE_STORAGE_DIR |
`` | Uploaded attachments directory (default: /var/lib/weavestream/files) |
BACKUP_STORAGE_DIR |
`` | Scheduled database backup directory (default: /var/lib/weavestream/backup) |
Volumes
| Path | Description |
|---|---|
/var/lib/weavestream/files |
Uploaded attachments and documents (shared with API) |
/var/lib/weavestream/backup |
Backup storage directory (worker writes scheduled database exports) |
This image is part of the Weavestream Stack.
Implementation Details
- Architectures: amd64
- User:
bsd(UID/GID set via PUID/PGID). Defaults to1000:1000. - Base: Built on
ghcr.io/daemonless/base(FreeBSD 15.1).
Need help? Join our Discord community.