Installation

Rostyman is a desktop application built with Electron. It runs on Windows, macOS, and Linux.

Download

Go to the Releases page and download the latest version for your platform.

Platform	File	Auto-update
Windows	Rostyman-x.x.x-Setup.exe	Yes
macOS	Rostyman-x.x.x.dmg	Yes
Linux	Rostyman-x.x.x.AppImage	Yes
Linux	rostyman_x.x.x_amd64.deb	Manual

Windows

1. Download Rostyman-x.x.x-Setup.exe from the releases page
2. Double-click to run the installer
3. If Windows SmartScreen shows a warning, click More info then Run anyway

   This warning appears because the app is not yet code-signed. It is safe to proceed.

4. Follow the installer steps
5. Rostyman launches automatically after installation

The installer places Rostyman in your user application directory (no admin rights needed) and creates a Start Menu shortcut.

macOS

1. Download Rostyman-x.x.x.dmg from the releases page

2. Open the .dmg file and drag Rostyman to your Applications folder

3. Important -- clear the quarantine flag before first launch:

   Open Terminal and run:

   xattr -cr /Applications/Rostyman.app

   macOS marks all apps downloaded from the internet as quarantined. Because Rostyman is not notarized with Apple, Gatekeeper will block it unless you remove the quarantine attribute with the command above.

4. Launch Rostyman from your Applications folder

If you skip the xattr step, macOS may show a dialog saying the app "is damaged and can't be opened" or "can't be opened because Apple cannot check it for malicious software." Running the xattr -cr command resolves this.

Linux

Two options are available: AppImage (recommended) and .deb package.

Option 1: AppImage (recommended)

1. Download Rostyman-x.x.x.AppImage from the releases page

2. Make the file executable:

   chmod +x Rostyman-x.x.x.AppImage

3. Run the application:

   ./Rostyman-x.x.x.AppImage

AppImage supports automatic updates — Rostyman will notify you when a new version is available and update itself.

On some distributions you may need to install FUSE to run AppImage files. Consult your distribution's documentation if you see a FUSE-related error.

Option 2: .deb package (Debian/Ubuntu)

1. Download rostyman_x.x.x_amd64.deb from the releases page

2. Install with:

   sudo dpkg -i rostyman_x.x.x_amd64.deb

3. Launch from your application menu or run rostyman in the terminal

The .deb package integrates with your system — adds a desktop entry, file associations for .rostyman files, and an app icon. Note: .deb does not auto-update. To update, download and install the new .deb file.

.rostyman File Association

After installing (either format), you can double-click any .rostyman file to open it directly in Rostyman.

First Launch

On first launch Rostyman will:

• Create a local SQLite database in the platform-specific app data directory:
  • Windows: %APPDATA%\Rostyman\
  • macOS: ~/Library/Application Support/Rostyman/
  • Linux: ~/.config/Rostyman/
• Create a default workspace
• Open with an empty request tab ready to use

No account, no sign-in, no internet connection required.

Auto-Updates

Rostyman checks for updates automatically in the background every 4 hours. When a new version is available:

1. The update downloads silently in the background
2. A native system notification informs you that an update is ready
3. A Update ready badge appears in the bottom status bar
4. Click the badge and choose Restart now to apply, or Later to install on next launch

You can also manually check for updates via the Help menu and selecting Check for Updates.