> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://www.comet.com/docs/opik/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://www.comet.com/docs/opik/_mcp/server.

# Self-host changelog

This page only lists breaking and critical changes that affect self-hosted Opik deployments. For the complete list of product updates, see the [product changelog](/changelog).

If you are upgrading from Opik 1.x to Opik 2.x, follow the [Opik 2.0 migration guide](/self-host/v1-to-v2-migration).

## Release 2.0.3 (Opik 2.0), 2026-04-20

### Backward Incompatible Change

Opik 2.0 organizes all data around **projects**. Data created on Opik 1.x — datasets, prompts, experiments, optimizations, automation rules, and alerts — is not visible in the Opik 2.0 UI until you run the background migration jobs that assign each item to a project. Follow the [Opik 2.0 migration guide](/self-host/v1-to-v2-migration) for the step-by-step instructions, including the required job order and the database backups to take first.

## Release 1.7.15, 2025-05-05

### Critical Changes

* Updated port mapping when using `opik.sh` - This may affect existing deployments
* Fixed persistence when using Docker compose deployments - Requires reconfiguration for existing deployments

## Release 1.7.11, 2025-04-21

### Security Change

* Updated Dockerfiles to ensure all containers run as non root users - This is a security-critical change that requires container recreation

## Release 1.7.0, 2025-04-09

### Backward Incompatible Change

In this release, we migrated the Clickhouse table engines to their replicated version. The migration was automated, and we don't expect any errors. However, if you have any issues, please check the [local deployment troubleshooting section](/self-host/local_deployment#troubleshooting) or feel free to open an issue in the [Opik repository](https://github.com/comet-ml/opik/issues).

## Release 1.0.3, 2024-10-29

### Backward Incompatible Change

The structure of dataset items has changed to include new dynamic fields. Dataset items logged before version 1.0.3 will still show but would not be searchable.
If you would like to migrate previous dataset items to the new format, please see the [dataset item migration instructions](https://github.com/comet-ml/opik/blob/main/apps/opik-backend/data-migrations/1.0.3/README.md) for more information.

## Release 1.0.2, 2024-10-21

### Backward Incompatible Change

* Updated datasets to support more flexible data schema - This change affects how dataset items are structured and may require updates to existing dataset insertion code. See the [Dataset documentation](/evaluation/advanced/manage_datasets) for details.
* The `context` field is now optional in the [Hallucination metric](/evaluation/metrics/hallucination) - This may affect existing evaluation configurations

## Release 1.0.1, 2024-09-30

### Backward Incompatible Change

* Changed dataset item insertion behavior - Duplicate items are now silently ignored instead of being ingested, which may affect data collection workflows. See the [Dataset documentation](/evaluation/advanced/manage_datasets) for details.

## Release 1.0.0, 2024-11-25

### Backward Incompatible Change

* Updated OpenAI integration to track structured output calls using `beta.chat.completions.parse` - This may affect existing OpenAI integration code. See the [OpenAI integration documentation](/integrations/openai) for details.
* Fixed issue with `update_current_span` and `update_current_trace` that did not support updating the `output` field - This may affect existing trace update code. See the [Tracing documentation](/tracing/advanced/log_traces) for details.

## Release 1.0.0, 2025-03-17

### Backward Incompatible Change

* Added support for images in google.genai calls - This may affect existing Gemini integration code. See the [Gemini integration documentation](/integrations/gemini) for details.
* [LangFlow integration](https://github.com/langflow-ai/langflow/pull/6928) has been merged - This may affect existing LangFlow deployments