Skip to content

Codex App (WSL mode on arm64 cpu not working) #13565

Open

Description

@TheBeems

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

26.304.1528.0

What subscription do you have?

Plus

What platform is your computer?

Microsoft Windows NT 10.0.26200.0 x64 (Snapdragon X Elite arm64 cpu)

What issue are you seeing?

When running the codex in WSL mode, it gives the following error:

Codex app-server exited unexpectedly (code=126, signal=null). Most recent error: /usr/bin/bash: line 1: /mnt/c/Users/user1/.codex/bin/wsl/codex: Success

ChatGPT suggested it might have to do with the architecture.

What steps can reproduce the bug?

  1. Install the Codex App from the Windows store
  2. Change runCodexInWindowsSubsystemForLinux to true

What is the expected behavior?

The Codex App starts normally.

Additional information

> uname -m
aarch64
> dpkg --print-architecture
arm64
> ls -l /mnt/c/Users/user1/.codex/bin/wsl/codex
-rwxrwxrwx 1 user1 user1 111740344 Mar  5 09:38 /mnt/c/Users/user1/.codex/bin/wsl/codex
> file /mnt/c/Users/user1/.codex/bin/wsl/codex
/mnt/c/Users/user1/.codex/bin/wsl/codex: ELF 64-bit LSB pie executable, x86-64, version 1 (SYSV), static-pie linked, stripped

Activity

  1. added
    appIssues related to the Codex desktop app
    on Mar 5, 2026
  2. added
    bugSomething isn't working
    windows-osIssues related to Codex on Windows systems
    on Mar 5, 2026
  3. github-actions commented on Mar 5, 2026

    @github-actions
    Contributor

    Potential duplicates detected. Please review them and close your issue if it is a duplicate.

    Powered by Codex Action

  4. added
    terminalIssues related to the in-app terminal
    appIssues related to the Codex desktop app
    bugSomething isn't working
    windows-osIssues related to Codex on Windows systems
    and removed
    bugSomething isn't working
    windows-osIssues related to Codex on Windows systems
    appIssues related to the Codex desktop app
    on Mar 6, 2026
  5. TheBeems commented on Mar 6, 2026

    @TheBeems
    Author

    Currently now official ARM64 build from openai, but the community has repackaged the official codex app to an ARM64 version, including working WSL, remote and Computer Use. You can find it on: https://github.com/airtaxi/codex-app-windows-arm64

    I use that version as my daily Codex App and it works great!

  6. Slipstream-Max commented on Mar 9, 2026

    @Slipstream-Max

    Exact same error.But i figured out to turn it off without reinstall.
    Go to 'C:\Users\YOURUSERNAME.codex'
    Open .codex-global-state.json with notepad or vscode.
    Search runCodexInWindowsSubsystemForLinux
    If its true rename it to false then save&quit.
    Reopen codex you'll find it works again.

  7. MertCtn commented on Mar 12, 2026

    @MertCtn

    Exact same error.But i figured out to turn it off without reinstall. Go to 'C:\Users\YOURUSERNAME.codex' Open .codex-global-state.json with notepad or vscode. Search runCodexInWindowsSubsystemForLinux If its true rename it to false then save&quit. Reopen codex you'll find it works again.

    Thank you so much it fixes my problem. It is shame on OpenAI don't fix such a simple think.

  8. StazriN commented on Mar 12, 2026

    @StazriN

    This is not exactly a "fix". It just configures the Codex App to switch back to the Windows native agent.
    WSL on ARM64 is still not supported.

  9. Slipstream-Max commented on Mar 12, 2026

    @Slipstream-Max

    This is not exactly a "fix". It just configures the Codex App to switch back to the Windows native agent. WSL on ARM64 is still not supported.

    they ship really slow

  10. davewthompson commented on Mar 16, 2026

    @davewthompson

    I see this as well on WSL 2, ARM CPU, Surface Laptop 7. The odd thing is if you wipe the entire .codex directory in LocalSettings and restart Codex and reconfigure it it's fine - so this does look like some form of internal issue inside the Codex app when using WSL2 on an ARM chipset.

  11. TheBeems commented on Mar 27, 2026

    @TheBeems
    Author

    I see this as well on WSL 2, ARM CPU, Surface Laptop 7. The odd thing is if you wipe the entire .codex directory in LocalSettings and restart Codex and reconfigure it it's fine - so this does look like some form of internal issue inside the Codex app when using WSL2 on an ARM chipset.

    Deleting de .codex directory resets it back to using native windows. Setting it back to WSL makes it crash again.

    I got my entire dev stack inside WSL, so having codex being able to start in WSL mode is a must have for me. Compiling for ARM64 shouldn't be much of a big problem.

  12. TheBeems commented on Apr 16, 2026

    @TheBeems
    Author

    @codex can you compile the Codex App for ARM64 please, so we can use WSL on our arm64 windows devices? This shouldn't take much of your compute to fix...

  13. TheBeems commented on May 10, 2026

    @TheBeems
    Author

    In issue #17491, a user named airtaxi made a repackaging project for the codex app to use native ARM64 binaries. I used it to add the required ARM64 binaries for WSL in airtaxi/codex-app-windows-arm64#3

    Everything is working now inside WSL. It is an unofficial hack for the meantime until OpenAI make their own ARM64 packaging with proper ARM64 codex binaries.

  14. tmptknn commented on Jun 3, 2026

    @tmptknn

    WSL still not working on arm64

  15. TheBeems commented on Jun 3, 2026

    @TheBeems
    Author

    @tmptknn , the community has fixed it in this repo: https://github.com/airtaxi/codex-app-windows-arm64 . It is unofficial, but the repackage works on arm64 including WSL and Computer Use.

  16. codeacula commented on Jun 16, 2026

    @codeacula

    My runCodexInWindowsSubsystemForLinux was in my .codex/config.toml, for anyone else coming here. Codex might've updated where it stored it, or I might've done something else and didn't realize it, but I did need to change that.

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 workingterminalIssues related to the in-app terminalwindows-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