Skip to content

Updates ​

Images of all components (flip-backend, flip-ai-core, flip-file-handlers, flip-frontend, flip-mcp-server) are published to the cr.yandex/crpbj8irels1kqult74e/onpremise registry and versioned according to Semantic Versioning — MAJOR.MINOR.PATCH. All five components are released under the same version number and updated together.

Before updating

Database migrations are applied automatically when the backend and ai-core containers start.

Docker Compose ​

  1. Set the new version in .env:
    ini
    FLIP_VERSION=v1.3.0
  2. Pull the images and restart the containers:
    bash
    docker compose pull
    docker compose up -d
    docker compose ps

Kubernetes (Helm) ​

  1. Set the new version in values.yaml, in the image.tag of each component: backend, ai-core, file-handlers, frontend, mcp-server.
  2. Apply the update:
    bash
    helm registry login cr.yandex --username json_key --password-stdin < credentials/authorized_key.json
    helm upgrade flip oci://cr.yandex/crpbj8irels1kqult74e/onpremise/flip-chart --version <chart version> -f values.yaml -n flip
    kubectl -n flip get pods

The latest tag

Use a specific version (v1.5.0), not latest.

Upgrading PostgreSQL 14 to 15 ​

The application supports PostgreSQL 14 and 15; upgrading the DBMS is optional. The PostgreSQL 14 and 15 data formats are incompatible, so moving to 15 requires a migration via a dump. The commands are for a Standalone installation; for an external PostgreSQL, use pg_dump/pg_restore or pg_upgrade.

  1. Stop the application services and create a dump on the current version (PostgreSQL 14):
    bash
    cd deploy/docker-compose
    docker compose stop flip-backend flip-file-handlers flip-mcp-server flip-ai-core
    docker compose exec flip-postgres sh -c 'PGPASSWORD="$POSTGRES_PASSWORD" pg_dump -U "$POSTGRES_USER" -d "$POSTGRES_DB" -F c -f /backup.dump'
    docker compose cp flip-postgres:/backup.dump ./backup-pg14.dump
    docker compose exec flip-postgres sh -c 'PGPASSWORD="$POSTGRES_PASSWORD" pg_dump -U "$POSTGRES_USER" -d flip_ai_core -F c -f /backup-ai-core.dump'
    docker compose cp flip-postgres:/backup-ai-core.dump ./backup-pg14-ai-core.dump
    docker compose down
  2. Replace docker-compose.yaml with the version for PostgreSQL 15 and delete the PostgreSQL data volume (find the volume name with docker volume ls | grep flip_postgres):
    bash
    docker volume rm docker-compose_flip_postgres
  3. Start PostgreSQL 15, create the ai-core database and restore the dumps:
    bash
    docker compose up -d flip-postgres
    docker compose exec flip-postgres sh -c 'createdb -U "$POSTGRES_USER" -O "$POSTGRES_USER" flip_ai_core'
    docker compose cp ./backup-pg14.dump flip-postgres:/backup.dump
    docker compose exec flip-postgres sh -c 'PGPASSWORD="$POSTGRES_PASSWORD" pg_restore -U "$POSTGRES_USER" -d "$POSTGRES_DB" --no-owner /backup.dump'
    docker compose cp ./backup-pg14-ai-core.dump flip-postgres:/backup-ai-core.dump
    docker compose exec flip-postgres sh -c 'PGPASSWORD="$POSTGRES_PASSWORD" pg_restore -U "$POSTGRES_USER" -d flip_ai_core --no-owner /backup-ai-core.dump'
  4. Start the application:
    bash
    docker compose up -d

Keep the backup-pg14.dump and backup-pg14-ai-core.dump files until you have verified that the application works.

flip on-premise and cloud documentation