Skip to content

Codex Desktop fails to start with migration 1 was previously applied but has been modified #23824

Closed as duplicate

Description

@miku-lilac

What version of the Codex App are you using (From “About Codex” dialog)?

26.520.11634

What subscription do you have?

Pro

What platform is your computer?

Microsoft Windows NT 10.0.26200.0 x64

What issue are you seeing?

Codex Desktop fails to launch with the following error:

Codex cannot access its local database.

Database path:
/mnt/c/Users/<user>/.codex/state_5.sqlite

Most recent error:
Error: failed to initialize sqlite state db at
/mnt/c/Users/<user>/.codex/state_5.sqlite:
failed to initialize state runtime at
/mnt/c/Users/<user>/.codex:
migration 1 was previously applied but has been modified

What steps can reproduce the bug?

  1. Install Codex Desktop on Windows
  2. Use WSL integration
  3. Launch Codex

What is the expected behavior?

No response

Additional information

No response

Activity

  1. added
    appIssues related to the Codex desktop app
    on May 21, 2026
  2. added
    bugSomething isn't working
    windows-osIssues related to Codex on Windows systems
    on May 21, 2026
  3. xdifu commented on May 21, 2026

    @xdifu

    For anyone landing here from search: this matches the CRLF/LF SQLx checksum issue tracked in #23777 / #23787. The WSL/Linux backend rejects a Windows-created state_5.sqlite because the stored _sqlx_migrations checksum was computed from different line-ending bytes.

    I published a non-destructive recovery tool here: https://github.com/xdifu/codex-repair

    Windows PowerShell / Windows Terminal:

    git clone https://github.com/xdifu/codex-repair.git
    cd codex-repair
    python codex-repair.py fix --apply

    If you run it from WSL bash to repair Windows Codex Desktop data, pass --codex-home "/mnt/c/Users/<WindowsUser>/.codex" so it does not target WSL's own ~/.codex.

    It backs up state_5.sqlite / logs_2.sqlite, schema-verifies before any checksum rewrite, and keeps ~/.codex/sessions/*.jsonl read-only.

  4. Nerexis commented on May 21, 2026

    @Nerexis

    @xdifu Your fix has worked fine for me. Thank you.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    appIssues related to the Codex desktop appbugSomething isn't workingwindows-osIssues related to Codex on Windows systems

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions