Run the Real ChatGPT Desktop App on Ubuntu Linux (Not a Wrapper)

Run the Real ChatGPT Desktop App on Ubuntu Linux (Not a Wrapper)

posted Originally published at dev.to 3 min read

TL;DR: OpenAI ships a Windows MSIX binary. You can unpack it, patch three platform assumptions, and run the actual official app natively on Ubuntu — same binary Windows users get. No Electron wrapper, no web view in a box.


The Problem With Every Other Guide

Search "ChatGPT desktop Ubuntu" and you'll find two things:

  1. Articles pointing you at lencx/ChatGPT — a third-party Electron wrapper that loads chatgpt.com in a window. It's not the real app.
  2. Articles pointing you at other wrappers doing the same thing.

These work, but you're getting a community-built shell around a website — not the app itself. The real ChatGPT Desktop (the one in the Windows Store) has features, update hooks, and auth flows that wrapper apps can't replicate cleanly.

This guide unpacks the official binary and runs it on Ubuntu 26.04. Tested on kernel 7.0.0, RTX 5070, NVIDIA 580/CUDA 13.0, both X11 and Wayland via XWayland.


What the Script Actually Does

  1. Extracts the x64 MSIX from the official .msixbundle
  2. Pulls out the official app.asar (the real app logic)
  3. Patches three platform assumptions so it boots on Linux:
    • Routes the platform chooser through the macOS-style implementation (Linux is close enough)
    • Disables macOS-only setVibrancy() calls
    • Skips the macOS ioreg device ID path
  4. Stages Linux Electron around the official app resources
  5. Packages everything as a proper .debchatgpt-desktop-native

You end up with a system package you can install, update, and uninstall like anything else.


Prerequisites

System packages

sudo apt-get install -y dpkg-dev nodejs python3 file

Local Electron tooling

mkdir ~/chatgpt-windows-deb && cd ~/chatgpt-windows-deb
npm install electron @electron/asar --no-save

Get the Official MSIX Bundle

You need the official Windows package from OpenAI. Download OpenAI.ChatGPT-Desktop_<version>.Msixbundle from the Microsoft Store or OpenAI's distribution endpoint and drop it in your working directory.

The repo includes the version current at time of writing as an example payload.


Build

cd ~/chatgpt-windows-deb
git clone https://github.com/johnohhh1/chatgpt_desktop_ubuntu .
npm install electron @electron/asar --no-save
./build-chatgpt-native-deb.sh --exe ./OpenAI.ChatGPT-Desktop_2026.212.2039.0.Msixbundle

Output lands in dist/:

dist/chatgpt-desktop-native_2026.212.2039.0_amd64.deb

Install

sudo apt-get install ./dist/chatgpt-desktop-native_2026.212.2039.0_amd64.deb

Rebuilding without a version bump? Force refresh:

sudo apt-get install --reinstall ./dist/chatgpt-desktop-native_2026.212.2039.0_amd64.deb

Register Auth Callback Handlers

The package installs a helper that registers your desktop session as the handler for the chatgpt: and chatgpt-alt: URL schemes (used for the login flow):

chatgpt-desktop-native-register

Verify it took:

xdg-mime query default x-scheme-handler/chatgpt
xdg-mime query default x-scheme-handler/chatgpt-alt

Both should return chatgpt-desktop-native.desktop.


Launch

chatgpt-desktop-native

The desktop entry sets the WM class to electron so GNOME binds the running window to the ChatGPT icon instead of the generic gear icon.


Known Quirks

  • The terminal will print Electron/NVIDIA/VA-API noise. This is normal — ignore it.
  • The success signal is functional login and working chat, not a clean terminal.
  • If GNOME still shows the generic icon after first launch: close the app fully and relaunch once. Stubborn shell? Log out and back in.
  • If OpenAI updates the Windows app significantly, the patch targets in build-chatgpt-native-deb.sh may need updating. PR welcome.

Reproducing on Another Machine

  1. Clone the repo to the target machine
  2. Drop a real ChatGPT .msix, .msixbundle, .appx, or .appxbundle in the directory
  3. npm install electron @electron/asar --no-save
  4. ./build-chatgpt-native-deb.sh --exe <your-payload>
  5. Install the generated .deb
  6. Run chatgpt-desktop-native-register
  7. Launch chatgpt-desktop-native

Repo

github.com/johnohhh1/chatgpt_desktop_ubuntu

Issues and PRs open. If a new MSIX version breaks the patches, open an issue with the version string and I'll update the patch targets.


Tested on Ubuntu 26.04 "Noble" with kernel 7.0.0-10, RTX 5070, NVIDIA driver 580, CUDA 13.0.strong text

More Posts

I Ported ComfyUI Desktop to Ubuntu 26.04 1 a day till I run out!

johnohhh1 - Apr 14

I Ported the Ollama Desktop App to Linux Just in Time for Ubuntu 26.04 LTS

johnohhh1 - Apr 11

Here is the Kimi Desktop on Ubuntu 26.04 noone asked for..... Because I am creating 1 desktop a day

johnohhh1 - Apr 13

Surviving a Kernel Panic: My Ubuntu War Story

Naomi Jepkorir - Apr 22

The Audit Trail of Things: Using Hashgraph as a Digital Caliper for Provenance

Ken W. Algerverified - Apr 28
chevron_left

Related Jobs

View all jobs →

Commenters (This Week)

2 comments
1 comment

Contribute meaningful comments to climb the leaderboard and earn badges!