Release Notes
What's new, improved, and fixed in each release
Find your current version: docker logs <container> | grep "Semaphor v"
For upgrade procedures, see the Upgrade Guide.
v0.1.38
April 12, 2026
Improvements
- Calculated field management. Card-scoped and sheet-shared calculated field workflows are clearer, and Semaphor now detects naming conflicts with domain-defined fields automatically.
- Data table pagination. Tables now remember your preferred page size across sessions. Dynamic page size options adapt to your dataset, making it easier to navigate large result sets.
- Data table sorting and rendering. Column types are now auto-detected for smarter sorting (numeric vs. text), and overall table rendering is faster and more consistent.
- Dashboard access control. Permission checks for dashboard editing are consolidated and more efficient, reducing overhead when loading dashboards.
Upgrade Notes
- Schema changes: None.
- New env vars: None.
- Breaking changes: None.
v0.1.36
April 10, 2026
Improvements
- Faster dashboard loading for embedded users. Optimized how dashboards resolve project context and retrieve data for embedded (OAuth) organization users, reducing load times.
- Calculated field editor polish. Improved error messaging, layout consistency, and spacing across the calculated field editor and toolbar controls.
Upgrade Notes
- Schema changes: None.
- New env vars: None.
- Breaking changes: None.
v0.1.34
April 8, 2026
What's New
- Structured error logging. All errors and failures — query failures, dashboard load errors, token generation issues, assistant errors, and more — are now emitted as structured JSON to the container's standard output. Use
docker logsto inspect them directly, or pipe them into your existing log aggregation tool (Datadog, Loki, CloudWatch, etc.) with no extra configuration. - Telemetry webhooks. Optionally forward those same error events to an external webhook endpoint in real time. Configure the webhook URL, choose which event types to subscribe to, and set a signing secret for request verification. Manage everything from Organization Settings.
Improvements
- Version display on self-hosted home page. The self-hosted landing page now shows your current Semaphor version with a direct link to release notes, so you can quickly see what you're running and what's changed.
- AI assistant conversation tracking. The AI assistant now maintains conversation context more reliably, improving follow-up responses within the same session.
Upgrade Notes
- Schema changes: New
telemetry_destinationstable. Runprisma migrate deployafter upgrading. - New env var:
ENTERPRISE_TELEMETRY_ENABLED— set totrueto enable webhook delivery (defaults to disabled).
v0.1.33
April 7, 2026
What's New
- Interactive API documentation. Full OpenAPI specifications are now published for all public endpoints — tokens, dashboards, visuals, domains, discovery, SQL execution, and unified security. Browse them from the new API Reference section.
- Dynamic visuals in the AI assistant. The AI assistant can now generate custom data-driven visualizations on the fly, in addition to standard chart types.
- Project and connection access controls. Only users with the appropriate role can create new projects or manage connections, preventing unauthorized changes.
Improvements
- Navigation clarity. The "Multi-tenancy" sidebar item has been renamed to "Security" for clearer navigation.
- MCP tool responses. MCP tool outputs now return structured content alongside text, making integration with MCP clients more reliable.
- Plugin asset loading. Plugin URLs now use the configured application base URL, ensuring consistent behavior across cloud and self-hosted deployments.
Upgrade Notes
- Schema changes: None.
- Encryption key validation. The Docker entrypoint now validates that
SYMMETRIC_ENCRYPTION_KEYis exactly 32 characters. If your existing key is a different length, startup will fail with a clear error message and instructions. Generate a valid key withopenssl rand -hex 16.
v0.1.31
April 2, 2026
What's New
- Custom visuals for self-hosted deployments. You can now publish and serve custom visualization plugins from your own S3-compatible storage. Set
APPS_BUCKET_NAMEandAPPS_BUCKET_REGIONin your Docker environment to enable plugin publishing. - Plugin management UI. Redesigned plugin page with improved navigation, upload dialogs, and permission controls.
Improvements
- Plugin asset paths now use canonical ID-based URLs for consistency between cloud and self-hosted environments.
Upgrade Notes
- Schema changes: None.
- New env vars:
APPS_BUCKET_NAME,APPS_BUCKET_REGION(required only if you want to publish custom visuals).
v0.1.25
March 24, 2026
What's New
- Unified Security. New security model that combines column-level, row-level, and table-level policies into a single workflow. Create policies, assign them to users or groups, and preview the effective result — all from one place. See Security Definitions and Security Assignments.
- Security assignment preview. Preview how security policies resolve for a specific user before saving, so you can verify access before it goes live.
- Dashboard controls. Interactive parameter controls that let dashboard viewers filter and adjust data without editing the dashboard.
Improvements
- Optimized security policy evaluation, reducing internal lookups during query execution.
Upgrade Notes
- Schema changes: New database tables for Unified Security. Run
prisma migrate deploybefore starting the new version. - Breaking changes: None. Existing CLS, RCLS, and TLS policies continue to work. Unified Security is opt-in per connection.
v0.1.195 and earlier
Upgrade Notes
- Minor internal schema cleanup. No impact for most deployments.
- Versions before v0.1.195 are not tracked here. If upgrading from a significantly older version, back up your database and contact support@semaphor.cloud for guidance.