Installation Guide

Get Request Man up and running on your system

Overview

Request Man is a cross-platform desktop application available for Windows, macOS, and Linux. Choose the installation method that works best for your platform.

System Requirements: Node.js 16+ is required for development mode. For the built application, no additional requirements are needed.

Windows Installation

Option 1: Windows Installer (Recommended)

Request Man for Windows

Version 1.0.0 • Installer Setup

Download Installer

Step 1: Download the Installer

Click the download button above to download Request.Man.Setup.1.0.0.exe.

Note: The installer is hosted on our official website. Download starts immediately when you click the button.
github.com/request-man/releases Request Man v1.0.0 Latest Release • Nov 28, 2025 📦 Request-Man-1.0.0-Portable.zip Windows • 85.3 MB Download

Step 2: Run the Installer

Right-click the downloaded ZIP file and select "Extract All" to a location of your choice.

📁 Downloads 🗜️ Request-Man-1.0.0 Portable.zip Extract 📂 Request-Man Folder Open Copy Extract All... Properties

Run Request Man

Navigate to the extracted folder and double-click Request Man.exe to launch the application.

📂 Request-Man Request Man .exe 2x 📄 README.md 📁 resources ⚙️ config.json ✓ Request Man Launches!

Option 2: Build from Source

# Clone the repository
git clone <repository-url>
cd "Request Man"

# Install dependencies
npm install

# Run in development mode
npm run electron:dev

# Or build for Windows
npm run electron:build:win
PowerShell - npm run electron:build:win > npm run electron:build:win Building Request Man for Windows... • Compiling TypeScript... ✓ TypeScript compiled successfully • Building Electron app... ✓ Electron app packaged • Creating installer... ✓ Installer created: Request-Man-Setup-1.0.0.exe • Generating checksums... ✓ Build completed successfully! Total time: 2m 34s

macOS Installation

Option 1: DMG Installer

Download the DMG

Download Request-Man-1.0.0.dmg from the releases page.

Open the DMG

Double-click the downloaded DMG file to mount it.

Install the Application

Drag the Request Man icon to the Applications folder.

Request Man Request Man Drag → 📁 Applications ✓ Drag Request Man to Applications folder

Launch Request Man

Open Launchpad or Applications folder and click Request Man.

Security Note: If macOS prevents the app from opening, go to System Preferences → Security & Privacy → General and click "Open Anyway".

Option 2: Build from Source

# Clone the repository
git clone <repository-url>
cd "Request Man"

# Install dependencies
npm install

# Run in development mode
npm run electron:dev

# Or build for macOS
npm run electron:build:mac

Linux Installation

Option 1: AppImage (Universal)

Download AppImage

Download Request-Man-1.0.0.AppImage from the releases page.

Make it Executable

chmod +x Request-Man-1.0.0.AppImage

Run the Application

./Request-Man-1.0.0.AppImage

Option 2: DEB Package (Debian/Ubuntu)

# Download the DEB package
wget <download-url>/Request-Man-1.0.0.deb

# Install
sudo dpkg -i Request-Man-1.0.0.deb

# Fix dependencies if needed
sudo apt-get install -f

# Launch
request-man

Option 3: RPM Package (Fedora/RHEL)

# Download the RPM package
wget <download-url>/Request-Man-1.0.0.rpm

# Install
sudo rpm -i Request-Man-1.0.0.rpm

# Or using DNF
sudo dnf install Request-Man-1.0.0.rpm

# Launch
request-man

Option 4: Build from Source

# Clone the repository
git clone <repository-url>
cd "Request Man"

# Install dependencies
npm install

# Run in development mode
npm run electron:dev

# Or build for Linux
npm run electron:build:linux

Development Setup

Prerequisites

Installation Steps

Clone the Repository

git clone <repository-url>
cd "Request Man"

Install Dependencies

npm install

This will install all required packages including Electron, React, and Vite.

Terminal - npm install > npm install npm WARN deprecated @babel/core@7.23.0 added 1247 packages in 45s Installing dependencies: ✓ electron@28.1.0 ✓ react@18.2.0 ✓ vite@5.0.8 ✓ typescript@5.3.3 ✓ axios@1.6.2 + 1242 more packages 132 packages are looking for funding run `npm fund` for details

Run Development Server

npm run electron:dev

This starts both the Vite development server and Electron with hot-reload enabled.

Terminal - npm run electron:dev > npm run electron:dev Starting development server... VITE v5.0.8 ready in 1247 ms ➜ Local: http://localhost:5173/ ➜ Network: use --host to expose Starting Electron... ✓ Electron process started ✓ Window opened successfully [HMR] Hot Module Replacement enabled ✓ Request Man loaded at http://localhost:5173 Watching for file changes... Press Ctrl+C to stop

Build for Production

# Build for current platform
npm run electron:build

# Build for specific platform
npm run electron:build:win    # Windows
npm run electron:build:mac    # macOS
npm run electron:build:linux  # Linux

Verify Installation

First Launch Checklist

Application Opens Successfully

Request Man should launch and display the main interface with the collections sidebar.

Request Man - API Testing Tool Welcome! Request Man v1.0.0 + New Request 📁 Import Collection 📖 View Documentation Start Testing APIs Build, test, and debug your APIs with ease ⚡ Request Builder Send HTTP requests 📁 Collections Organize requests 🔐 Authentication 7 auth types Get Started → Ready v1.0.0

Test a Simple Request

Try sending a GET request to https://httpbin.org/get to verify functionality.

Request Man - Testing httpbin.org Request GET https://httpbin.org/get Send Sending... Response 200 OK 324 ms 1.2 KB Body Headers Cookies { "url": "https://httpbin.org/get", "headers": { "User-Agent": "Request-Man/1.0.0" }, "origin": "203.0.113.0" }

Check Features

Verify that all tabs and features are accessible:

  • Collections sidebar
  • Request builder tabs
  • Collection runner
  • Environment manager
  • Cookie jar
  • Console

Troubleshooting

Common Issues

Windows: "Windows protected your PC" warning

Click "More info" and then "Run anyway". This appears because the app isn't digitally signed yet.

macOS: "Request Man can't be opened" error

Go to System Preferences → Security & Privacy → General tab and click "Open Anyway" next to the message about Request Man.

Linux: Permission denied error

chmod +x Request-Man-1.0.0.AppImage

Development: Port 5173 already in use

# Kill the process using port 5173
# Windows
netstat -ano | findstr :5173
taskkill /PID <PID> /F

# macOS/Linux
lsof -ti:5173 | xargs kill -9

Build fails with "Electron builder error"

# Clear cache and reinstall
rm -rf node_modules
npm cache clean --force
npm install

Updates

Checking for Updates

Request Man will automatically check for updates on startup (coming soon). You can also manually check:

Updating the Application

Download New Version

Download the latest installer/package for your platform.

Close Request Man

Make sure Request Man is completely closed before updating.

Install Update

Run the new installer. Your collections and settings will be preserved.

Data Safety: All your collections, environments, and settings are stored separately and won't be affected by updates.

Next Steps

Quick Start Guide

Learn the basics in 5 minutes

Request Builder

Create your first API request

Collections

Organize your requests

Authentication

Secure your API calls