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.

Native builds are available for both x64 and ARM64 — choose an ARM64 build only for ARM hardware (Windows on Arm, Raspberry Pi, ARM servers/cloud); otherwise pick x64. The download page auto-detects your OS and CPU and highlights the right one.

Platform	File	Auto-update
Windows (x64 / ARM64)	Rostyman-Setup-x.x.x-x64.exe or …-arm64.exe	Yes
macOS (Apple Silicon / Intel)	Rostyman-x.x.x-arm64.dmg or …-x64.dmg	Manual
Linux (x64 / ARM64)	Rostyman-x.x.x-x64.AppImage or …-arm64.AppImage	Yes
Linux (x64 / ARM64)	rostyman_x.x.x_amd64.deb or …_arm64.deb	Manual
Linux (x64 / ARM64)	rostyman-x.x.x.x86_64.rpm or ….aarch64.rpm	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

Three options are available: AppImage (works on any distribution), .deb (Debian/Ubuntu), and .rpm (Fedora/RHEL/openSUSE). Each is built for both x64 and ARM64 — pick ARM64 only for ARM hardware (Raspberry Pi, ARM servers/cloud).

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

   You can also use sudo apt install ./rostyman_x.x.x_amd64.deb. With apt you may see a note like N: Download is performed unsandboxed as root … (13: Permission denied) — that's harmless (apt's sandbox user can't read your Downloads folder) and the package still installs. To avoid it, install from a shared path such as /tmp.

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.

Option 3: .rpm package (Fedora/RHEL/openSUSE)

1. Download rostyman-x.x.x.x86_64.rpm (or rostyman-x.x.x.aarch64.rpm for ARM64) from the releases page

2. Install with:

   sudo dnf install ./rostyman-x.x.x.x86_64.rpm

   On openSUSE use sudo zypper install ./rostyman-x.x.x.x86_64.rpm.

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

Like .deb, the .rpm package adds a desktop entry, .rostyman file associations, and an app icon, and does not auto-update — download and install the new .rpm to update.

.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.

Uninstalling

Rostyman also has a built-in Help → Uninstall Rostyman that removes your data, shortcuts, and icons — see the per-platform notes below for what it can and can't do.

Windows

Use Settings → Apps → Installed apps → Rostyman → Uninstall (or Start menu → right-click Rostyman → Uninstall). The in-app Help → Uninstall Rostyman does the same and also clears your data.

macOS

Quit Rostyman, then drag it from Applications to the Trash. To clear leftover data, delete ~/Library/Application Support/Rostyman. The in-app Help → Uninstall Rostyman removes the app bundle and data for you.

Linux

How you uninstall depends on how you installed:

• .deb (Debian/Ubuntu): sudo apt remove rostyman (use sudo apt purge rostyman to also drop config).
• .rpm (Fedora/RHEL): sudo dnf remove rostyman (on openSUSE: sudo zypper remove rostyman).
• AppImage: delete the .AppImage file and its menu entry:

  rm -f Rostyman-*.AppImage ~/.local/share/applications/rostyman.desktop

To remove leftover data for any install type (your collections database, settings, cache):

rm -rf ~/.config/Rostyman ~/.cache/Rostyman

In-app uninstall on Linux

Help → Uninstall Rostyman removes your data, shortcuts, and icons — and for an AppImage it also deletes the binary. For a .deb/.rpm install it cannot remove the installed package (that needs root), so it shows you the apt/dnf command to run yourself to finish the removal.