← Back to Docs

Installation

Get AsterIDE up and running on your system.

System Requirements

Minimum Requirements

  • • Windows 10 (64-bit) or later
  • • macOS 10.15 (Catalina) or later
  • • 2GB RAM
  • • 100MB free disk space

Recommended

  • • 4GB RAM or more
  • • SSD for better performance
  • • Modern web browser (for web features)
  • • Git (for development)

Download Options

Windows

Download the standalone application for Windows 10 and 11.

Download .exe

v0.1.5-stable

macOS

Download the app for macOS Intel and Apple Silicon.

Download .dmg

v0.1.5-stable

Linux

Choose from AppImage, .deb, or .rpm packages.

Installation Steps

Windows

  1. Download the AsterIDE application (.exe)
  2. Save the file to your preferred location
  3. Double-click the .exe file to launch AsterIDE
  4. If Windows Defender shows "Windows protected your PC", click "More info" then "Run anyway"
  5. (Optional) Create a desktop shortcut for easy access
  6. (Optional) Add to Start Menu for quick launching

macOS

  1. Download the AsterIDE disk image (.dmg)
  2. Double-click the .dmg file to mount it
  3. Drag AsterIDE.app to your Applications folder
  4. Eject the disk image (drag to Trash or click eject button)
  5. Launch AsterIDE from Applications folder
  6. If Gatekeeper shows "AsterIDE.app cannot be opened because Apple cannot check it for malicious software", click "Cancel"
  7. Go to System Settings → Privacy & Security
  8. Scroll down to "AsterIDE.app was blocked" section and click "Allow Anyway"
  9. Try launching AsterIDE again and click "Open" when prompted

Build from Source

For Developers

If you want to contribute or build AsterIDE from source, you'll need Rust and Node.js installed.

# Clone the repository
git clone https://github.com/Aster-IDE/AsterIDE.git
cd AsterIDE

# Build the application
cargo build --release

# Run the application
cargo run
View full contributing guide →Download Source

Verify Installation

After installation, verify AsterIDE is working correctly:

  1. Launch AsterIDE
  2. Check the version in Help → About
  3. Create a new file to test basic functionality
  4. Try opening an existing file
  5. Test text editing and basic shortcuts

Having trouble? Check our troubleshooting guide or open an issue.