Cursor Setup on Fedora

Prerequisites

• Fedora 39 or later
• Active internet connection
• Sudo privileges

Installation

Method 1: Installation via AppImage (Recommended)

1. Download the latest version of Cursor from the official website:

1
2
cd ~/Downloads
wget https://downloader.cursor.sh/linux/appImage/x64 -O cursor.AppImage

1. Make the file executable:

1
chmod +x cursor.AppImage

1. Move the AppImage to an appropriate directory:

1
2
sudo mkdir -p /opt/cursor
sudo mv cursor.AppImage /opt/cursor/

1. Create a desktop shortcut:

1
2
3
4
5
6
7
8
9
cat > ~/.local/share/applications/cursor.desktop << EOF
[Desktop Entry]
Name=Cursor
Exec=/opt/cursor/cursor.AppImage --no-sandbox
Icon=cursor
Type=Application
Categories=Development;IDE;
Comment=AI-powered code editor
EOF

Method 2: Installation via RPM Package

1. Download the RPM package:

1
wget https://downloader.cursor.sh/linux/rpm/x64 -O cursor.rpm

1. Install the package:

1
sudo dnf install ./cursor.rpm

Initial Configuration

First Launch

1. Launch Cursor from the applications menu or via command:

1
cursor

1. Sign in with your Cursor account or create a new one

2. Accept necessary permissions

Recommended Configuration

Basic Settings

Access settings via Ctrl + , or File > Preferences > Settings

• Theme: Choose your preferred theme (Dark+, Light+, etc.)
• Font Size: Adjust to your preference (recommended: 14-16)
• Auto Save: Enable afterDelay for automatic saving

AI Configuration

1. Configure your API key (if needed) in settings
2. Enable real-time code suggestions
3. Configure preferred AI models (GPT-4, Claude, etc.)

Recommended Extensions

Install useful extensions from the marketplace:

• GitLens
• Prettier
• ESLint
• Python
• Docker
• Live Server

Git Integration

Configure Git if not already done:

1
2
git config --global user.name "Your Name"
git config --global user.email "[email protected]"

Fedora Optimizations

Increase File Watchers (for large projects)

1
2
echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf
sudo sysctl -p

Configure Permissions for Wayland

Fedora uses Wayland by default. Add these flags to the desktop entry if you experience rendering issues:

1
2
sudo nano ~/.local/share/applications/cursor.desktop
# Add to the Exec line: --enable-features=UseOzonePlatform --ozone-platform=wayland

SELinux Considerations

If Cursor fails to launch due to SELinux, allow the AppImage to execute:

1
chcon -t bin_t /opt/cursor/cursor.AppImage

Essential Keyboard Shortcuts

• Ctrl + Shift + P: Command palette
• Ctrl + K: Open AI chat
• Ctrl + L: Select code and chat with AI
• Ctrl + /: Comment/uncomment
• Ctrl + P: Quick file search
• Ctrl + Shift + F: Global project search
• Ctrl + \`: Open integrated terminal

Troubleshooting

Issue: Cursor won’t launch

1
2
# Try with no-sandbox mode
/opt/cursor/cursor.AppImage --no-sandbox

Issue: Permission errors

1
sudo chown -R $USER:$USER ~/.config/cursor

Issue: Theme or graphics rendering incorrect under Wayland

Add these flags at launch:

1
cursor --disable-gpu-sandbox --enable-features=UseOzonePlatform --ozone-platform=wayland

Updates

Cursor typically updates automatically. To force a manual update, download the latest version from the official website and repeat the installation steps.

Uninstallation

If installed via AppImage:

1
2
3
sudo rm -rf /opt/cursor
rm ~/.local/share/applications/cursor.desktop
rm -rf ~/.config/cursor

If installed via RPM:

1
2
sudo dnf remove cursor
rm -rf ~/.config/cursor

Resources

• Official website: https://cursor.sh
• Documentation: https://docs.cursor.sh
• Support: https://forum.cursor.sh