This is how to install Grok Bot. You download the desktop app (or the phone app), sign in with your account in the browser, and let Grok Bot set up the cloud computer your Bots work on. When you see your first Bot in the sidebar, you’re ready for lesson 1.4.
What you’ll build
By the end of this lesson you will have:
- The Grok Bot app installed on your computer or phone.
- The app signed in to your account.
- Your Bot’s cloud computer set up.
- Your first Bot, named Grok Bot, in the sidebar, with one reply from it.
Before you start
- Your plan includes Grok Bot. Not sure? Read lesson 1.2, plans and accounts to sort out first.
- You know which account you’ll sign in with. Grok Bot uses your Cursor account. There’s no separate Grok Bot login.
- Your device is supported:
• Mac: Apple silicon or Intel.
• Windows: x64 or Arm64.
• Linux: x64 or Arm64, as a.debpackage, an.rpmpackage or an AppImage.
• iPhone: iOS 18 or later. The iPhone app also runs on iPad with iPadOS 18 or later.
• Android: Android 9 or later. - You have a few minutes to keep the app open while the computer sets up.
Step by step
Step 1: Download the right installer
- Go to the Grok Bot page in your Cursor dashboard: cursor.com/dashboard/bot.
- Find the Download Grok Bot row and choose the version for your system.
- You can also download it from x.ai/bot.
#### Mac (Apple silicon or Intel)
- Pick the Mac download. If you’re not sure which chip you have, open the Apple menu and choose About This Mac.
- Open the file you downloaded and follow the usual Mac install steps.
#### Windows (x64 or Arm64)
- Pick the Windows download for your processor. Most Windows PCs are x64.
- Open the installer and follow the steps on screen.
#### Linux (x64 or Arm64)
- Pick
.deb(Debian, Ubuntu),.rpm(Fedora and other RPM systems) or the AppImage. - Install the package with your system’s package tools, or make the AppImage executable and run it.
- On a
.debor.rpminstall, updates come through your package manager, not the app. See Keep it updated.
#### iPhone and Android
- iPhone or iPad: get Grok Bot from the App Store.
- Android: get Grok Bot from Google Play.
- Open the app and choose Log In or Sign Up. Finish sign-in in the browser with the same account you use on desktop.
Step 2: Open the app and sign in
- Open Grok Bot.
- On the welcome screen, choose Sign in.
- Your browser opens. Finish signing in there with your Cursor account. The sign-in page may show Grok or xAI branding. That’s expected.
- Keep Grok Bot open while you sign in. If it doesn’t come back to the front when you’re done, switch back to it yourself.
If your company uses single sign-on (SSO), use your company’s login, not a personal account. If your access comes from a seat on a self-serve Grok Business plan, choose Sign in with Grok in the browser and use the Grok account that holds the seat.
Signing in only proves who you are. It doesn’t link or combine your X, Grok or Cursor accounts, and it doesn’t change your plan.
If you get Grok Bot through SuperGrok or X Premium+, the app asks you to link that account after you sign in. Lesson 1.4 covers this in detail (see the Foundations lessons).
Step 3: Wait for your computer to set up
Your Bots work on their own computer in the cloud. The first time you sign in, Grok Bot sets it up.
- Keep the app open while it shows Setting up your Grok Bot…. On a phone, the home screen shows Starting your computer….
- This can take several minutes. If the progress is still changing, wait.
- If it says Taking longer than usual, Keep waiting is the safe choice.
Step 4: Check it’s ready and say hello
- After a short intro, Grok Bot creates your first Bot, named Grok Bot, and opens a chat with it.
- Check that Grok Bot appears in the sidebar.
- Type a first message and press Enter:
Paste this into: Grok Bot chat, message box.
Hello! I just installed you. In three short bullet points, tell me what you can help me with and what you need from me first.
- Wait for the reply. That’s your install done.
Copy-paste prompts
Paste this into: Grok Bot chat, message box.
Hello! I just installed you. In three short bullet points, tell me what you can help me with and what you need from me first.
Paste this into: Grok Bot chat, message box.
Which device am I talking to you from, and is your computer set up and ready? Answer in one line.
Expected result
You should now see:
- The app open and signed in.
- No setup progress screen.
- Grok Bot in the sidebar.
- A reply to your first message.
We haven’t run this lesson on our test account yet. Screens and button names may differ on your app version.
Keep it updated
The desktop app and your Bot’s cloud computer update separately.
- Mac and Windows: the app checks for updates on its own. When one is ready, the account menu shows New update available. Choose Install, then Restart to update. To check yourself, open Settings → Updates → Check for Updates. Automatic Updates is on by default.
- Linux
.debor.rpm: Check for Updates only tells you a new version is out. Update with your package manager:
Paste this into: Grok Bot chat, message box.
Debian or Ubuntu: sudo apt update && sudo apt install --only-upgrade grok-bot Fedora or other RPM systems: sudo dnf upgrade --refresh grok-bot
- iPhone and Android: updates come from the App Store or Google Play.
- “Update required”: if your version is more than 14 days old and a newer one is out, the app covers its window with Update required. Choose Update, wait for the download, then choose Restart to update. Your Bots keep running in the cloud while you update.
Updating the app doesn’t reset your Bot’s computer.
Common mistakes
- Closing the browser tab before sign-in finishes. Keep Grok Bot open, finish in the browser, then switch back. If it’s stuck, choose Sign in again. If you’re already in the app, use Sign In with Cursor in Settings.
- Signing in with the wrong account. Your plan sits on one account. If the app says you don’t have access, sign out and sign in with the account that pays for Grok Bot.
- An error about Legacy Privacy Mode. Grok Bot needs cloud data storage, so Privacy Mode (Legacy) isn’t supported. Switch your Cursor account to Privacy Mode, or ask your company admin to change the team setting.
- The app hangs on launch. Fully quit and reopen it. On a Mac, choose Quit from the menu bar. Closing the window isn’t enough.
- Linux shows a new version but won’t update.
.deband.rpminstalls don’t update themselves. Run the package manager command above, then restart Grok Bot. - Confusing the Grok app with Grok Bot. They’re two different apps. A paywall or a Weekly SuperGrok Limit message in the Grok app isn’t about Grok Bot.
Stuck? If the app won’t start, sign in or connect, see if the app won’t start or connect. The help hub covers “can’t reach your computer”, “reconnecting” and “update” errors.
Safety and usage
- One computer for all your Bots. Every Bot on your account shares one cloud computer, including its files and browser logins. Don’t treat separate Bots as a privacy wall.
- Usage. Each Bot reply uses some of your plan’s usage, including your first hello. Lesson 1.2 explains how usage is counted.
- Passwords. Never type a password or code into chat. You’ll learn the safe way (Vault and secure forms) in later lessons.
Saved in this browser only; no account needed.
Then: 1.6 set up your first Bot next
Level progress: Foundations, lesson 1.3.
Related builds: see what you can build.
FAQ
Is there a Grok Bot app for iPhone and Android?
Yes. The iPhone app needs iOS 18 or later and also runs on iPad with iPadOS 18 or later. The Android app needs Android 9 or later.
Does Grok Bot run on Linux?
Yes, on x64 and Arm64, as a .deb package, an .rpm package or an AppImage.
Do I need a separate Grok Bot account?
No. Grok Bot signs in with your Cursor account. There’s no separate Grok Bot login.
Can I install Grok Bot on two computers?
Yes. Sign in with the same account on each one. Your Bots and conversations sync across the devices you’re signed in on. Some settings, like letting a Bot run commands on your own computer, are set per desktop.
Do my Bots stop if I close my laptop?
No. Bot work runs on the cloud computer, so closing the app, laptop or phone doesn’t stop it.
Written with Grok, checked against the docs on Nov 4, 2026. Nothing in this lesson has been run on our test account yet. – Supported systems, download from cursor.com/dashboard/bot or x.ai/bot, sign in with Cursor account, SSO, Grok Business “Sign in with Grok”, first Bot named “Grok Bot”, automatic update checks: https://docs.x.ai/grok-bot/get-started – Sign-in page may show Grok or xAI branding; signing in doesn’t link accounts: https://docs.x.ai/x-subscription/grok-bot-sign-in – Phone versions (iOS 18, Android 9, iPadOS 18), App Store and Google Play links, Log In or Sign Up, don’t buy a second subscription, “Starting your computer…”, phone limits: https://docs.x.ai/grok-bot/mobile and https://docs.x.ai/grok-bot/get-started – Linux packages, platforms list, Bots keep working when the laptop is closed, Grok app vs Grok Bot: https://docs.x.ai/grok-bot/faq – Sign-in loop steps, Legacy Privacy Mode, “Setting up your Grok Bot…”, hang on launch, “Update required” after 14 days, Linux update commands, Settings → Updates: https://docs.x.ai/grok-bot/troubleshooting – Automatic Updates default: https://docs.x.ai/grok-bot/settings-and-notifications – Bots sync across devices, “Execution on this computer” per desktop: https://docs.x.ai/grok-bot/faq and https://docs.x.ai/grok-bot/approvals-security-and-privacy – Every Bot reply counts toward usage: https://docs.x.ai/grok-bot/chat-and-collaboration – Shared cloud computer: https://docs.x.ai/grok-bot/computer-and-apps – Download page: https://x.ai/bot