Installation: Install the desktop version in 5 minutes
When you search for "Grok Bot installation," you're most likely stuck at the first step: you open the official site but can't find an obvious "Download" button. In fact, there are three official entry points for the Grok Bot installer, and the app itself is very lightweight—it's just a client for chatting, reviewing, and approving; the Bot does its work on cloud computers.
So downloading and installing really only takes 5 minutes; including logging in and seeing your first Bot, this lesson takes 8 minutes in total.
In the previous lesson you confirmed that your subscription includes Grok Bot (1.2 Subscriptions and Pricing); now let's install it.
What you'll be able to do after this lesson
- Get the Grok Bot installer from one of the three official entry points: Download Grok Bot in the Cursor dashboard, x.ai/bot, or ask your administrator for a link
- Install the desktop app on Windows (x64 / Arm64), macOS (Apple silicon / Intel), or Linux (x64 / Arm64)
- Sign in with your Cursor account—there is no separate Grok Bot login; Grok Business seats will use Sign in with Grok, and SuperGrok / X Premium+ follow the prompts to link
- After logging in, see the first automatically created Bot, named Grok Bot, and open a chat with it
- Know where to check first when installation fails or login gets stuck: 1.4 Getting Started Troubleshooting
Your current predicament
- You want to download Grok Bot, but the official homepage shows no download button, and the "installers" you find in search results are of unknown origin
- You got stuck at the login step: the browser clearly shows a successful login, but the app keeps spinning in place
- You're not sure whether your computer can run it—Windows Arm edition? Linux? Or can you only use a phone?
When to use this approach
When you need to:
- Install the Grok Bot desktop version on your own macOS, Windows, or Linux computer
- Sign in directly with your existing Cursor account, without registering a new account
- See your first Bot as soon as possible and start assigning tasks
And you don't want to:
- Download a "Grok Bot installer" from third-party websites—stick to official entry points only
- Fiddle with command-line installation, direct version links, and bulk deployment—that's what 1.3 Alternative Installation Methods is for
🎒 Preparation before starting
- Finish reading 1.2 Subscriptions and Pricing and confirm that your subscription includes Grok Bot (The X Subscription's Plus and Free do not include it)
- A macOS (Apple silicon or Intel), Windows (x64 or Arm64), or Linux (x64 or Arm64) computer
- A network that can reach
cursor.com(to download the installer) andx.ai,spacex.ai(for account login) - Know your login situation: direct Cursor account login, Grok Business seat, or SuperGrok / X Premium+ requiring linking
- Note for Cursor accounts with Privacy Mode (Legacy) enabled: Grok Bot requires cloud data storage, and such accounts will be prompted to switch to Privacy Mode before starting—just follow the prompt to switch
System Requirements
| Platform | Architecture | Installer Format |
|---|---|---|
| macOS | Apple silicon、Intel | .dmg |
| Windows | x64、Arm64 | Setup .exe |
| Linux | x64、Arm64 | .deb、.rpm、AppImage |
Phones can also run it (iPhone requires iOS 18+, Android requires 9+); installation and usage details are covered separately in 1.6 Mobile.
Core Idea
Grok Bot installation = a very lightweight desktop app + Cursor account login. The app is your window for operating the Bot: sending messages, watching it work, and approving actions all happen here, while the Bot's actual work runs on cloud computers. That's why the official process is just three steps—download, install, log in—and it's ready to use once installed.
There are three download entry points; pick the one that fits you:
| Entry Point | Address | Who It's For |
|---|---|---|
| Cursor dashboard (recommended) | cursor.com/dashboard/bot's Download Grok Bot row | Individuals or team members with dashboard access |
| Official website entry | x.ai/bot; the full list of installers for all platforms is at cursor.com/download/bot | No dashboard access and want to get the installer directly |
| Administrator | Ask your admin for the download link | Company-managed setup, no dashboard access |
The Download Grok Bot row installs the app directly, or copies a download link you can share with others—handy when setting up a colleague's machine.
Once the app is installed, it automatically checks for updates (tested on the 2026-11-20 official release source; the current stable version is 1.2.3). Versions that are too old will be forced to update—this is covered in the pitfalls section.
💡 Users in China
The desktop app interface ships with 20+ languages, including Simplified and Traditional Chinese; step 4 after installation walks you through switching. As for what the company has officially confirmed about registration, payment, and networking, the 1.7 China usage guide only states things with a source.
Follow along
Step 1: Download the Grok Bot installer (pick one of three official entry points)
Why: the official docs list only these three desktop download entry points—"installers" from other channels have no official backing, so steer clear.
Option A: Cursor dashboard (recommended)
Open cursor.com/dashboard/bot and click the Download Grok Bot row.
Option B: Official website entry
Open x.ai/bot to download; or go to cursor.com/download/bot, which lists the current installer for every platform.
Option C: Ask your administrator
No dashboard access and your company manages software centrally? Ask your admin for the download link.
You should see: the browser starts downloading the installer for your platform (macOS is .dmg, Windows is Setup .exe, Linux is .deb / .rpm / AppImage), or you've obtained a shareable download link.
- The installer has started downloading, and the format matches my system
Step 2: Install Grok Bot desktop (Windows / macOS / Linux)
Why: the app is the foundation for everything that follows—sign-in, chat, and approvals all happen inside it.
macOS users
Open the downloaded .dmg and drag Grok Bot into Applications.
Windows users
Run Setup .exe and follow the prompts to finish installation.
Linux users
Install the .deb or .rpm package, or run the AppImage directly. Details on command-line installation and package-manager upgrades are in 1.3b Alternative install methods.
You should see: Grok Bot appears in your launcher / Start menu; the first launch shows a welcome screen with a Sign in button.
- The app opens normally and I see the welcome screen
Step 3: Sign in with your Cursor account and meet your first Bot
Why: Grok Bot uses the Cursor account system—there is no separate Grok Bot sign-in, so your existing account is your pass.
Follow the path that matches your situation:
| Your situation | How to sign in |
|---|---|
| Cursor account (personal / team / SSO) | Choose Sign in on the welcome screen and complete authentication in the browser; if your company uses SSO, follow your usual company sign-in flow |
| Self-serve Grok Business seat | Choose Sign in with Grok in the browser and sign in with the Grok account that holds the seat |
| SuperGrok / X Premium+ | Complete the linking when the app prompts you; on desktop, find Settings → Usage & Billing and Get Access with Grok |
You should see: the browser shows that Cursor sign-in succeeded and the app returns to the foreground; after a brief intro, Grok Bot automatically creates your first Bot—named Grok Bot—and opens a chat window with it. You don't need to create anything manually.
To create more Bots: click + in the sidebar → Create a Bot → name it → Create. Giving each Bot a clear responsibility works far better than one jack-of-all-trades Bot.
- I see the first Bot named Grok Bot and its chat window
⚠️ Sign-in stuck?
Keep the app open and confirm the browser shows that Cursor sign-in succeeded; if the app doesn't return to the foreground automatically, switch back manually; if it still doesn't work, click Sign in again on the welcome screen (if you're already in the app, use Sign In with Cursor in Settings). The official fixes—sign-in loops, clearing cookies, incognito windows—are covered in 1.4 Getting-started troubleshooting.
Step 4: Switch the interface to Chinese and confirm the update settings
Why: a Chinese interface makes daily use easier; double-checking the update settings means you won't suddenly be blocked by an "Update required" message later.
Two small things:
- Switch to Chinese: Settings → General → Appearance → Language, and choose Simplified Chinese (or Follow System to follow the system). There are 20+ languages in total, including Simplified/Traditional Chinese
- Check for updates: Settings → Updates shows the installed version, with two buttons, Check for Updates and Restart to Update; Automatic Updates is on by default—when the screen is locked or the screensaver is active, the computer has been idle for at least 10 minutes, and the Grok Bot isn't busy, updates install automatically and the app restarts. Linux
.deb/.rpminstalls go through the system package manager and don't show this toggle
You should see: the interface switched to Chinese; in Settings → Updates you can see the current version number (the stable version verified in practice on the 2026-11-20 official release source is 1.2.3). To check the latest version number, the official release source is available at any time:
curl -s https://api2.cursor.sh/updates/api/download/stable/darwin-arm64/sandThe returned JSON contains version (current version) and downloadUrl (installer download URL). The {platform} values for each platform and the direct version links are in 1.3b Alternative installation methods.
Checkpoint ✅
- Grok Bot app opens normally on my computer
- I successfully signed in with my Cursor account (or completed the Sign in with Grok / link flow)
- I saw the first Bot, automatically created and named Grok Bot, along with its chat window
- I know how to create another Bot: in the sidebar, + → Create a Bot
- When something goes wrong, I know to first go to 1.4 getting-started troubleshooting instead of reinstalling the app
Pitfall reminders
❌ Downloading the "Grok Bot installer" from third-party websites
There are only three official entry points: the Download Grok Bot row on cursor.com/dashboard/bot, x.ai/bot (the installer list is at cursor.com/download/bot), and the link from your administrator. Any other "installer" is of unknown origin—don't install it.
❌ Reinstalling the app when sign-in gets stuck
The official troubleshooting guide is very direct: reinstalling usually doesn't fix sign-in issues. First follow the prompt box in step 3 to self-check; if you hit a sign-in loop, clear the browser cache and cookies for cursor.com and x.ai, retry in an incognito window, and sign in to x.ai/bot on desktop with the same Cursor account; if it just failed, wait 30–60 minutes and try again. Full steps are in 1.4 getting-started troubleshooting.
❌ Panicking at a Legacy Privacy Mode error
This doesn't mean the installation is broken: Grok Bot requires cloud data storage, while your Cursor account is on Privacy Mode (Legacy). Follow the prompt to switch to Privacy Mode, or ask your organization's administrator to update the account's data settings.
❌ Version too old, app blocked by a full-screen "Update required"
Grok Bot's policy is: if the version is more than 14 days old and a newer version exists, a full-screen Update required prompt appears. Click Update and wait for the download to finish, then click Restart to update—Bots keep running in the cloud during the update. If the download fails, click Try again, or Download the latest version to install it yourself.
Advanced tips (optional)
Company-wide bulk deployment: IT uses MDM (Jamf, Intune, ConfigMgr, etc.) to push installers, perform silent Windows installs with /S, and pin tested versions—the full workflow is in Enterprise IT deployment.
Check versions and history: Support → About → Copy version info copies version info in one click; version-related thresholds (e.g., Vault requires 0.75.2+) are in Versions and updates.
Mobile: Official apps are available on both the App Store and Google Play (iOS 18+ / Android 9+), with the same account and same Bots—1.6 Mobile covers installation and assigning tasks anytime.
FAQ
What is Grok?
Grok Bot is a very lightweight desktop app that serves as your window for operating the Bot: sending messages, watching it work, and approving actions all happen here. The Bot's actual work runs on a cloud computer, not on your computer.
Where is the Grok download link?
There are three official entry points: the cursor.com/dashboard/bot Download Grok Bot row on the Cursor dashboard (recommended), x.ai/bot (the full list of installers for all platforms is at cursor.com/download/bot), or ask your administrator for a download link. Any "installers" from other channels are of unknown origin—do not install them.
Grok Bot download official site—how do I install it on mobile?
There is an official mobile app: it's available on both the App Store and Google Play. iPhone requires iOS 18+, Android requires 9+, with the same account and same Bots. Installation and usage details are covered separately in 1.6 Mobile.
How do I fix Grok errors?
First, identify which error it is: if login is stuck, keep the app open and confirm that the browser shows Cursor login succeeded; if you hit a login loop, clear the browser cache and cookies for cursor.com and x.ai, then retry in an incognito window—reinstalling usually doesn't fix login problems. Seeing a Legacy Privacy Mode error doesn't mean the installation is broken; just switch to Privacy Mode as prompted. Full steps are in 1.4 Getting Started Troubleshooting.
What if the app is blocked by a full-screen "Update required" message?
This happens when the version is older than 14 days and a newer one is available. Click Update and wait for the download to finish, then click Restart to update—Bots keep running in the cloud during the update. If the download fails, click Try again, or Download the latest version to install it yourself.
Lesson summary
✅ You got the Grok Bot installer from one of the three official entry points: Download Grok Bot on the Cursor dashboard (recommended), x.ai/bot, or an administrator link.
✅ You installed the desktop app on Windows, macOS, or Linux—it's just a lightweight client; the Bot's work runs on cloud computers.
✅ You signed in successfully with your Cursor account (Grok Business seats go through Sign in with Grok, SuperGrok / X Premium+ via the prompted link) and saw the first Bot, automatically created and named Grok Bot.
✅ You switched the interface to Chinese and confirmed that Automatic Updates is on by default and that versions older than 14 days are force-updated.
Key information recap:
| Item | Key points |
|---|---|
| Download entry points | cursor.com/dashboard/bot (recommended), x.ai/bot, administrator link |
| Installer formats | macOS .dmg / Windows Setup .exe / Linux .deb .rpm AppImage |
| Sign-in methods | Cursor account; Business seats Sign in with Grok; SuperGrok / X Premium+ linked |
| First Bot | Created automatically after sign-in, named Grok Bot |
| Updates | Automatic updates on by default; versions older than 14 days trigger a forced Update required |
Next lesson preview
Installation done. The next lesson covers alternative installation methods: Alternative installation methods: direct version links, silent installs, and Linux packages.
You will learn:
- Versioned direct-link templates — download exactly the version you tested
- Windows silent install
/Sand install location%LOCALAPPDATA% - Linux deb / rpm / AppImage and upgrade commands with
apt/dnf
If everything goes smoothly and you don't care about bulk deployment, you can jump straight to 1.5 your first Bot and give it its first task; if the installation gets stuck somewhere, first check 1.4 getting-started troubleshooting.