Troubleshooting
Reqjet won’t install or start
Section titled “Reqjet won’t install or start”The downloads aren’t code signed yet, so browsers and operating systems check with you first. See the first time you run it. With Windows 11’s Smart App Control turned on, unsigned apps can’t run at all: install Reqjet from the Microsoft Store instead, which is signed by Microsoft.
A request goes to the wrong place, or a variable isn’t filled in
Section titled “A request goes to the wrong place, or a variable isn’t filled in”- Check the environment picker at the top right: is the right environment selected for this folder?
- The response’s Variables tab shows each value that went into the request and where it came from.
- A variable with no value is sent as written (
{{name}}), and an Unresolved variables warning above the response names it. Check the name’s spelling, and that the env files are in the.httpfile’s folder or a parent folder. (Runbook steps don’t send at all until every value is known.) - See Where a value comes from for the order values are looked up in.
A sign-in fails
Section titled “A sign-in fails”- OAuth 2.0: the request’s Auth tab shows the token’s state. Get new token signs in again. The error explains which setting is missing or wrong.
- Windows sign-in on Linux or macOS needs a Kerberos ticket (
kinit) or, for NTLM with a user name on Linux, thegss-ntlmssppackage. The 401 response explains which. - The Token tab shows whether a JWT you sent had expired.
Certificate errors
Section titled “Certificate errors”- A server with a self-signed certificate fails the certificate check. For your own development servers, set
verifyHostCertificatetofalsefor that environment. See Certificates. - The Timing tab shows the server’s certificate, its issuer and its valid dates.
Behind a company proxy
Section titled “Behind a company proxy”Requests use the system proxy by default. If they time out, set the proxy in Preferences. See Proxies.
Changes made outside Reqjet don’t show up
Section titled “Changes made outside Reqjet don’t show up”Reqjet watches your folders for changes. If a folder can’t be watched, the status bar says so. On Linux, a very large folder can reach the system’s limit on watched folders, and the message says how to raise it. Meanwhile, press Refresh to pick up changes.
Reporting a problem
Section titled “Reporting a problem”- Open Preferences › Troubleshooting and choose Copy diagnostic info. It copies Reqjet’s version, your operating system, where the settings and logs are, and recent errors. Nothing from your requests is included.
- If you can, attach the log: Open log folder shows it. Reqjet logs its own errors, never your requests, and keeps the logs for a week.
- Open an issue with the diagnostic info and what you were doing.
An unexpected error doesn’t close Reqjet: the status bar says something went wrong, and the details go in the log.