Installation Guide

Choose your operating system and follow the steps to install Mantra.

About Download Links

The download links (mantra.gonewx.com/download) in this document will become active after the official product release. Please follow official announcements for the latest download information.

System Requirements Overview

Before installing, ensure your system meets these requirements:

OS	Minimum Version	Architecture	Disk Space
macOS	10.15 (Catalina)	Intel / Apple Silicon	~100MB
Windows	10	64-bit	~100MB
Linux	Ubuntu 18.04+ / Fedora 32+ / Debian 10+	64-bit	~100MB

macOS Installation

System Requirements

• Operating System: macOS 10.15 (Catalina) or later
• Processor: Intel or Apple Silicon (M1/M2/M3/M4)
• Disk Space: Approximately 100MB available space
• Permissions: Administrator privileges required for installation

Option 1: Download DMG Installer (Recommended)

This is the easiest installation method, suitable for most users.

1. Download the Installer

   Visit the Mantra Download Page and download the .dmg file for macOS.

   Choose the Right Version

   • Apple Silicon (M1/M2/M3/M4): Download Mantra-x.x.x-arm64.dmg
   • Intel Mac: Download Mantra-x.x.x-x64.dmg

   Not sure which Mac you have? Click the Apple menu → "About This Mac" to check the "Chip" or "Processor" information.

   💡 The x.x.x in filenames represents the version number. Please refer to the actual version shown on the download page.

2. Open the Installer

   Double-click the downloaded .dmg file to open the installation window.

3. Install the Application

   Drag the Mantra icon to the Applications folder.

4. First Launch

   Open the Applications folder, find Mantra, and double-click to launch.

   First Launch Security Notice

   On first launch, macOS may display a message saying the app "cannot be opened because the developer cannot be verified."

   Solution:

   1. Right-click the Mantra application icon
   2. Select "Open"
   3. Click "Open" in the dialog that appears

   You only need to do this once; subsequent launches will work normally.

Option 2: Using Homebrew (Not Yet Available)

Not Yet Available

Homebrew installation is being prepared. Please use the DMG download from the official website for now.

If you have Homebrew installed, you can quickly install via command line:

brew install --cask mantra

Advantages of Homebrew Installation

• One command to install
• Easy updates: brew upgrade --cask mantra
• Unified application management

Update Mantra:

brew upgrade --cask mantra

Uninstall Mantra:

brew uninstall --cask mantra

Windows Installation

System Requirements

• Operating System: Windows 10 or later
• Architecture: 64-bit system
• Disk Space: Approximately 100MB available space
• Permissions: Administrator privileges required for installation

How to Check System Architecture

Press Win + I to open Settings → System → About, and check if "System type" shows "64-bit operating system."

Option 1: Download Installer (Recommended)

1. Download the Installer

   Visit the Mantra Download Page and download the Windows installer Mantra-Setup-x.x.x.exe.

2. Run the Installer

   Double-click the downloaded .exe file to launch the setup wizard.

   Windows SmartScreen Notice

   On first run, Windows SmartScreen may display "Windows protected your PC."

   Solution:

   1. Click "More info"
   2. Click "Run anyway"

   This appears because the application hasn't been signed by Microsoft yet, but downloads from the official website are safe.

3. Complete Installation

   Follow the setup wizard prompts to choose the installation location and complete the installation.

4. Launch Mantra

   After installation, you can launch Mantra by:

   • Searching for "Mantra" in the Start menu
   • Double-clicking the desktop shortcut (if created)

Option 2: Using Scoop (Not Yet Available)

Not Yet Available

Scoop installation is being prepared. Please use the installer download from the official website for now.

Scoop is a command-line installer for Windows. If you have Scoop installed:

scoop bucket add extras
scoop install mantra

Update Mantra:

scoop update mantra

Uninstall Mantra:

scoop uninstall mantra

Option 3: Using Winget (Not Yet Available)

Not Yet Available

Winget installation is being prepared. Please use the installer download from the official website for now.

Windows 10/11 includes the built-in package manager Winget:

winget install Mantra.Mantra

Update Mantra:

winget upgrade Mantra.Mantra

Uninstall Mantra:

winget uninstall Mantra.Mantra

Linux Installation

System Requirements

• Distributions: Ubuntu 18.04+, Debian 10+, Fedora 32+, Arch Linux, or other major distributions
• Architecture: 64-bit (x86_64)
• Disk Space: Approximately 100MB available space
• Dependencies: GTK 3, libnotify (pre-installed on most desktop distributions)

Option 1: AppImage (Recommended, No Installation Required)

AppImage is a portable application format that runs without installation, compatible with all Linux distributions.

1. Download AppImage

   Visit the Mantra Download Page and download Mantra-x.x.x.AppImage.

2. Add Execute Permission

   chmod +x Mantra-x.x.x.AppImage

3. Run the Application

   ./Mantra-x.x.x.AppImage

Advantages of AppImage

• No root privileges required
• Doesn't affect other system software
• Easy to try different versions
• Can be run from any location

Option 2: DEB Package (Not Yet Available)

Not Yet Available

DEB package and APT repository are being prepared. Please use AppImage for now.

For Debian, Ubuntu, Linux Mint, and other Debian-based distributions.

# Download DEB package
wget https://mantra.gonewx.com/download/mantra_x.x.x_amd64.deb

# Install
sudo dpkg -i mantra_x.x.x_amd64.deb

# If there are dependency issues, run
sudo apt-get install -f

Or install directly with apt (if you've added the repository):

# Add GPG key
curl -fsSL https://mantra.gonewx.com/gpg-key.asc | sudo gpg --dearmor -o /usr/share/keyrings/mantra-archive-keyring.gpg

# Add repository
echo "deb [signed-by=/usr/share/keyrings/mantra-archive-keyring.gpg] https://mantra.gonewx.com/apt stable main" | sudo tee /etc/apt/sources.list.d/mantra.list

# Update and install
sudo apt update
sudo apt install mantra

Option 3: RPM Package (Not Yet Available)

Not Yet Available

RPM package is being prepared. Please use AppImage for now.

For Fedora, RHEL, CentOS, openSUSE, and other RPM-based distributions.

# Download RPM package
wget https://mantra.gonewx.com/download/mantra-x.x.x.x86_64.rpm

# Fedora/RHEL 8+
sudo dnf install ./mantra-x.x.x.x86_64.rpm

# CentOS 7/older RHEL
sudo yum localinstall ./mantra-x.x.x.x86_64.rpm

Option 4: AUR (Not Yet Available)

Not Yet Available

AUR package is being prepared. Please use AppImage for now.

Arch Linux users can install from the AUR:

# Using yay
yay -S mantra-bin

# Or using paru
paru -S mantra-bin

Option 5: Flatpak (Not Yet Available)

Not Yet Available

Flatpak installation is being prepared. Please use AppImage for now.

If your system supports Flatpak:

flatpak install flathub dev.mantra.Mantra

Run:

flatpak run dev.mantra.Mantra

Option 6: Snap (Not Yet Available)

Not Yet Available

Snap installation is being prepared. Please use AppImage for now.

If your system supports Snap:

sudo snap install mantra

Installation Verification

After installation, verify that Mantra is installed correctly.

Launch the Application

Launch Mantra, and you should see the welcome screen:

Version Check

If Mantra provides a command-line tool, you can verify the installation with:

macOS/Linux

mantra --version

Windows

mantra --version

After successful installation, you should see output similar to:

Mantra version x.x.x

Signs of Successful Installation

• [x] Application launches normally
• [x] Welcome screen displays correctly
• [x] Can create new projects or open existing ones

Troubleshooting

macOS Common Issues

"Mantra" cannot be opened because the developer cannot be verified

Cause: macOS Gatekeeper security prevents unsigned applications.

Solution:

1. Right-click the Mantra application
2. Select "Open"
3. Click "Open" in the dialog

Or in System Preferences:

1. Open "System Preferences" → "Security & Privacy"
2. Under the "General" tab, click "Open Anyway"

"Mantra" is damaged and can't be opened

Cause: Some download tools may corrupt the file's extended attributes.

Solution: Run the following command in Terminal to remove the quarantine attribute:

xattr -cr /Applications/Mantra.app

Apple Silicon Mac starts slowly or won't launch

Cause: You may have downloaded the Intel version instead of the ARM version.

Solution: Ensure you download the Apple Silicon version (filename contains arm64).

Windows Common Issues

Windows SmartScreen blocks the application

Cause: The application hasn't received Microsoft signature certification.

Solution:

1. Click the "More info" link
2. Click "Run anyway"

Ensure you download from the official website for safety.

"This app can't run on your PC" error during installation

Cause: You may have downloaded the wrong version, or your system is not 64-bit.

Solution:

1. Confirm your system is 64-bit (Settings → System → About)
2. Re-download the correct version of the installer

Missing VCRUNTIME140.dll or other DLL files

Cause: Missing Visual C++ runtime library.

Solution: Download and install the Microsoft Visual C++ Redistributable.

Linux Common Issues

AppImage won't run

Cause: Execute permission not added or FUSE is missing.

Solution:

# Add execute permission
chmod +x Mantra-x.x.x.AppImage

# If it still won't run, install FUSE
# Ubuntu/Debian
sudo apt install fuse libfuse2

# Fedora
sudo dnf install fuse fuse-libs

DEB/RPM package installed but won't launch

Cause: Missing dependencies.

Solution:

# Debian/Ubuntu - fix dependencies
sudo apt-get install -f

# Fedora - check dependencies
sudo dnf check

# View detailed errors
mantra --verbose

Display issues (blurry interface or abnormal scaling)

Cause: High DPI screen scaling issues.

Solution: Try launching with these environment variables:

# Method 1: Force scaling
GDK_SCALE=2 ./Mantra-x.x.x.AppImage

# Method 2: Disable automatic DPI scaling
QT_AUTO_SCREEN_SCALE_FACTOR=0 ./Mantra-x.x.x.AppImage

Uninstall Instructions

macOS Uninstall

Manual Uninstall:

1. Quit the Mantra application
2. Open Finder → Applications
3. Drag Mantra to the Trash
4. (Optional) Delete configuration files:

   rm -rf ~/Library/Application\ Support/Mantra
   rm -rf ~/Library/Preferences/dev.mantra.Mantra.plist

Uninstall with Homebrew:

brew uninstall --cask mantra

Windows Uninstall

1. Open "Settings" → "Apps" → "Installed apps"
2. Search for "Mantra"
3. Click "..." → "Uninstall"
4. Follow the prompts to complete uninstallation

Or via Control Panel:

1. Open "Control Panel" → "Programs" → "Programs and Features"
2. Find Mantra, right-click and select "Uninstall"

Uninstall with Package Managers:

Scoop

scoop uninstall mantra

Winget

winget uninstall Mantra.Mantra

Linux Uninstall

AppImage: Simply delete the AppImage file.

rm Mantra-x.x.x.AppImage

DEB Package:

sudo apt remove mantra
# Or completely remove (including configuration)
sudo apt purge mantra

RPM Package:

sudo dnf remove mantra
# Or
sudo yum remove mantra

Flatpak:

flatpak uninstall dev.mantra.Mantra

Snap:

sudo snap remove mantra

Delete Configuration Files (Optional):

rm -rf ~/.config/Mantra
rm -rf ~/.local/share/Mantra

Next Steps

After installation, read the Getting Started guide to learn how to use Mantra.

Having Issues?

If the troubleshooting steps above don't solve your problem:

• Check the FAQ
• Visit GitHub Issues to search or submit issues
• Join the Community Discussion