> ## Documentation Index
> Fetch the complete documentation index at: https://notes.kodekloud.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Demo Installation and Setup
> This guide covers the installation and setup of the AI-powered code editor Cursor on Windows, macOS, and Linux.
In this guide, we’ll walk through installing **Cursor**, the AI-powered, cross-platform code editor, on **Windows**, **macOS**, and **Linux**. By the end, you’ll have Cursor up and running with your preferred account, extensions, and settings across all environments.
***
## Installing on Windows
1. Download the Windows installer from [cursor.com](https://cursor.com).
2. Run the installer and accept the license agreement to proceed.
3. Select any additional tasks, such as:
* Creating a desktop icon
* Adding an **“Open with Cursor”** context menu
* Registering Cursor as the default editor
* Adding Cursor to the system `PATH`
Then click **Next**.
4. Wait for installation to complete, then click **Finish** to launch Cursor.
5. On first launch, sign in with your preferred account.
6. Once authenticated, you’ll see the main dashboard where you can:
* Open an existing project
* Clone a repository
* Connect via SSH
***
## Installing on macOS
1. Download the macOS **.dmg** from [cursor.com](https://cursor.com).
2. Double-click to mount and drag the Cursor icon into **Applications**.
3. (Optional) Add Cursor to your Dock for quick access.
4. Open Cursor; macOS will prompt you to confirm launching an app downloaded from the internet.
5. Configure initial settings:
* **Keyboard shortcuts**
* **AI language preferences**
* **Codebase-wide indexing**
* Install the `cursor` shell command for terminal access
6. After installing the shell command, you’ll see a confirmation popup.
7. Choose whether to import your existing [VS Code](https://code.visualstudio.com) extensions, settings, & keybindings or start fresh.
8. Sign in via your browser and allow the system prompt to open Cursor.
9. After logging in, customize your theme, account, and privacy settings on the main interface.
***
## Installing on Linux
Cursor is distributed as an **AppImage** on Linux platforms (e.g., [Ubuntu](https://ubuntu.com)).
1. Download the AppImage from [cursor.com](https://cursor.com) and place it in your **Downloads** or **Apps** directory.
2. Make the AppImage executable:
* **Graphical**: Right-click → **Properties** → **Permissions** → Tick *Allow executing file as program*
* **Terminal**:
```bash theme={null}
cd ~/Apps
chmod +x Cursor.AppImage
./Cursor.AppImage
```
If you encounter an error about `libfuse.so.2`, install FUSE before launching:
```bash theme={null}
sudo apt-get update && sudo apt-get upgrade -y
sudo apt install libfuse2
./Cursor.AppImage
```
3. On first launch, configure your preferences and import [VS Code](https://code.visualstudio.com) extensions just like on macOS.
4. Sign in to your Cursor account to sync settings and projects.
***
## Quickstart: Verify Your Setup
Cursor’s integrated terminal adapts to each OS:
* **Windows**: PowerShell, Command Prompt, or WSL
* **macOS**: Z shell (zsh)
* **Linux**: Bash
Create a simple Python project to ensure everything is working:
```python theme={null}
# hello_world.py
def main():
print("Hello, World!")
if __name__ == "__main__":
main()
```
Run it in Cursor’s terminal:
```bash theme={null}
python3 hello_world.py
# Output:
# Hello, World!
```
On Ubuntu, you can pin Cursor to the Dock (Dash) by right-clicking its icon and selecting **Add to Favorites**.
***
## References
* [Cursor Official Site](https://cursor.com)
* [VS Code Documentation](https://code.visualstudio.com/docs)
* [Ubuntu Linux](https://ubuntu.com)
* [FUSE on Linux](https://github.com/libfuse/libfuse)