Skip to content

Installation Guide

This guide covers installing the NexusAI Deployer on your system.

Download

Download the installer for your operating system from the provided distribution channel.

Available Formats

Platform Format File
Windows NSIS Installer NexusAI-Installer-Setup-x.x.x.exe
Windows Portable NexusAI-Installer-x.x.x-portable.exe
macOS DMG NexusAI-Installer-x.x.x.dmg
Linux AppImage NexusAI-Installer-x.x.x.AppImage
Linux DEB nexus-installer_x.x.x_amd64.deb

Windows Installation

  1. Run the installer
  2. Double-click NexusAI-Installer-Setup-x.x.x.exe

  3. If prompted by Windows Defender, click "More info" → "Run anyway"

  4. Choose installation options

  5. Select installation directory (default: C:\Program Files\NexusAI Installer)
  6. Choose whether to create desktop shortcut

  7. Choose whether to create Start Menu shortcut

  8. Complete installation

  9. Click "Install" to begin
  10. Wait for installation to complete
  11. Click "Finish" to launch the application

Using the Portable Version

  1. Extract the portable executable
  2. No installation required

  3. Run directly from any location

  4. Launch the application

  5. Double-click NexusAI-Installer-x.x.x-portable.exe

Windows Requirements

  • Windows 10 version 1903 or later
  • Windows 11 (any version)
  • 64-bit operating system
  • .NET Framework 4.7.2 or later (usually pre-installed)

macOS Installation

  1. Open the DMG file

  2. Double-click NexusAI-Installer-x.x.x.dmg

  3. Install the application

  4. Drag the NexusAI Installer icon to the Applications folder

  5. First launch

  6. Open from Applications folder
  7. If blocked by Gatekeeper:
    • Go to System Preferences → Security & Privacy
    • Click "Open Anyway" for NexusAI Installer

macOS Requirements

  • macOS 10.15 (Catalina) or later
  • Apple Silicon (M1/M2) or Intel processor
  • 4GB RAM minimum

Linux Installation

Using AppImage

  1. Make executable 

    chmod +x NexusAI-Installer-x.x.x.AppImage

  2. Run the application 

    ./NexusAI-Installer-x.x.x.AppImage

Using DEB Package (Debian/Ubuntu)

  1. Install the package 

    sudo dpkg -i nexus-installer_x.x.x_amd64.deb

  2. Install dependencies (if needed) 

    sudo apt-get install -f

  3. Launch from applications menu or terminal 

    nexus-installer

Linux Requirements

  • Ubuntu 20.04 LTS or later
  • Debian 10 or later
  • Other distributions with glibc 2.31+
  • X11 or Wayland display server

Verifying Installation

After installation, verify the application works correctly:

1. Launch the Application

The welcome screen should appear:

Home Screen

2. Check Backend Connectivity

  • Click "Get Started"
  • The capability list should load successfully:

Capability Selection

If you see "Failed to load capabilities", refer to the Troubleshooting Guide.

Uninstallation

Windows

Using installer: - Go to Settings → Apps → NexusAI Installer → Uninstall

Or use Control Panel: - Control Panel → Programs → Uninstall a program → NexusAI Installer

macOS

  • Drag NexusAI Installer from Applications to Trash
  • Empty Trash

Linux (DEB)

sudo apt remove nexus-installer

Linux (AppImage)

  • Simply delete the AppImage file

Configuration Files

The application stores configuration in:

Platform Location
Windows %APPDATA%\NexusAI Installer\
macOS ~/Library/Application Support/NexusAI Installer/
Linux ~/.config/NexusAI Installer/

Firewall Configuration

The application requires outbound access to:

Service Port Purpose
AWS APIs 443 (HTTPS) CloudFormation, IAM, S3, etc.
AWS STS 443 (HTTPS) Credential validation

Ensure your firewall allows outbound HTTPS connections to AWS endpoints.

Proxy Configuration

If your network uses a proxy:

  1. System proxy - The application uses system proxy settings
  2. Environment variables - Set HTTP_PROXY and HTTPS_PROXY
# Linux/macOS
export HTTP_PROXY=http://proxy.example.com:8080
export HTTPS_PROXY=http://proxy.example.com:8080

# Windows (PowerShell)
$env:HTTP_PROXY = "http://proxy.example.com:8080"
$env:HTTPS_PROXY = "http://proxy.example.com:8080"

Troubleshooting Installation

Windows: "Windows protected your PC"

  1. Click "More info"
  2. Click "Run anyway"
  3. This is normal for new applications

macOS: "App can't be opened"

  1. Go to System Preferences → Security & Privacy
  2. Click the lock to make changes
  3. Click "Open Anyway" next to NexusAI Installer

Linux: AppImage won't run

  1. Ensure it's executable: chmod +x *.AppImage
  2. Install FUSE if needed: sudo apt install fuse

Application won't start

  1. Check system requirements
  2. Try running from command line to see errors
  3. Check if antivirus is blocking the application

Next Steps