FAQ and Troubleshooting

FAQ and Troubleshooting

Install & launch

macOS says "unidentified developer" / can't open the app. The releases aren't code-signed yet. Right-click getman.app → Open → confirm. Or run xattr -dr com.apple.quarantine /Applications/getman.app.

Windows SmartScreen blocks it. Click More info → Run anyway. (Same reason — no code-signing cert.)

Windows: the app won't start when I copy just the .exe. Ship/keep the whole Release folder — getman.exe needs its sibling DLLs and data/ folder.

Is there an Intel macOS / Linux ARM build? Official releases are Apple-Silicon (arm64) macOS and x86-64 Linux. For other architectures, Building from Source on that machine.

Auto-update? Not yet — re-download from Releases when a new version ships.

Requests

My {{variable}} was sent literally / not replaced. Either no Environments and Variables is active, the name doesn't match (names are case-sensitive), or the variable is undefined. Unknown variables are intentionally left verbatim so the problem is visible. Check the URL-bar highlighting (resolved vs. unresolved colour) and the active environment in the selector.

A multipart file upload fails or shows an error response. Make sure the file still exists at the path you picked. If it's missing at send time, Getman returns a clear error response. File pickers (multipart/binary) work on desktop/mobile, not the web build.

A request seems stuck "sending." Click CANCEL/STOP. If it timed out, raise the timeouts in Settings (Connect/Send/Receive).

TLS/SSL errors against a self-signed server. For testing only, turn off VERIFY SSL in Settings → Network. For mutual TLS, configure a client certificate (mTLS) in Settings (desktop/mobile).

Too many redirects / want fewer. Toggle FOLLOW REDIRECTS or adjust MAX REDIRECTS in Settings.

Responses

A big response shows as plain text with a banner. That's the Responses viewer keeping the UI fast. Click PRETTIFY ANYWAY, or enable ALWAYS PRETTIFY LARGE RESPONSES in Settings.

A restored tab shows "[response body over 1 MB was not persisted]". Bodies over ~1 MB aren't saved to disk to avoid bloat. Re-send the request to view it again.

Web build

The hosted web demo runs in a browser, which imposes limits the desktop app doesn't have:

• CORS: the browser blocks cross-origin requests without the right response headers, so many APIs fail from the demo even though they work on desktop. This is a browser security model, not a Getman bug.
• WebSocket headers: browsers can't set custom headers on a WS handshake — use a query param or subprotocol for auth.
• SSE: may buffer rather than stream incrementally under the browser HTTP adapter.
• File pickers, workspace folders, and mTLS are desktop/mobile features.
• Storage is per-browser (IndexedDB), scoped to the origin.

For the full experience, use a desktop build.

Data

Where is my data? How do I back it up? It's in a local database your OS manages (see Data Privacy and Storage). Back up collections via the Import Export and Git Workspace.

How do I clear cookies / history? Cookies: Settings → COOKIES → MANAGE or CLEAR. History: bounded by the history limit; see History.

Still stuck?

Open an issue on GitHub.