[{"data":1,"prerenderedAt":645},["ShallowReactive",2],{"navigation_docs":3,"-getting-started-troubleshooting":172,"-getting-started-troubleshooting-surround":640},[4,30,100,134],{"title":5,"icon":6,"path":7,"stem":8,"children":9,"page":29},"Getting started","i-lucide-rocket","\u002Fgetting-started","1.getting-started",[10,14,18,21,25],{"title":11,"path":12,"stem":13},"Introduction","\u002Fgetting-started\u002Fintroduction","1.getting-started\u002F1.introduction",{"title":15,"path":16,"stem":17},"Installation","\u002Fgetting-started\u002Finstallation","1.getting-started\u002F2.installation",{"title":5,"path":19,"stem":20},"\u002Fgetting-started\u002Fquick-start","1.getting-started\u002F3.quick-start",{"title":22,"path":23,"stem":24},"Build from source","\u002Fgetting-started\u002Fbuild-from-source","1.getting-started\u002F4.build-from-source",{"title":26,"path":27,"stem":28},"Troubleshooting","\u002Fgetting-started\u002Ftroubleshooting","1.getting-started\u002F5.troubleshooting",false,{"title":31,"icon":32,"path":33,"stem":34,"children":35,"page":29},"Guide","i-lucide-book-open","\u002Fguide","2.guide",[36,40,44,48,52,56,60,64,68,72,76,80,84,88,92,96],{"title":37,"path":38,"stem":39},"Interface","\u002Fguide\u002Finterface","2.guide\u002F01.interface",{"title":41,"path":42,"stem":43},"Workspace","\u002Fguide\u002Fworkspace","2.guide\u002F02.workspace",{"title":45,"path":46,"stem":47},"Collections","\u002Fguide\u002Fcollections","2.guide\u002F03.collections",{"title":49,"path":50,"stem":51},"HTTP requests","\u002Fguide\u002Fhttp-requests","2.guide\u002F04.http-requests",{"title":53,"path":54,"stem":55},"Variables","\u002Fguide\u002Fvariables","2.guide\u002F05.variables",{"title":57,"path":58,"stem":59},"Authorization","\u002Fguide\u002Fauthorization","2.guide\u002F06.authorization",{"title":61,"path":62,"stem":63},"Scripts and tests","\u002Fguide\u002Fscripts-and-tests","2.guide\u002F07.scripts-and-tests",{"title":65,"path":66,"stem":67},"Collection runner","\u002Fguide\u002Fcollection-runner","2.guide\u002F08.collection-runner",{"title":69,"path":70,"stem":71},"Import and export","\u002Fguide\u002Fimport-export","2.guide\u002F09.import-export",{"title":73,"path":74,"stem":75},"Code snippets","\u002Fguide\u002Fcode-snippets","2.guide\u002F10.code-snippets",{"title":77,"path":78,"stem":79},"gRPC","\u002Fguide\u002Fgrpc","2.guide\u002F11.grpc",{"title":81,"path":82,"stem":83},"WebSocket","\u002Fguide\u002Fwebsocket","2.guide\u002F12.websocket",{"title":85,"path":86,"stem":87},"Cookies, proxy and certificates","\u002Fguide\u002Fcookies-proxy-certificates","2.guide\u002F13.cookies-proxy-certificates",{"title":89,"path":90,"stem":91},"Settings","\u002Fguide\u002Fsettings","2.guide\u002F14.settings",{"title":93,"path":94,"stem":95},"Keyboard shortcuts","\u002Fguide\u002Fkeyboard-shortcuts","2.guide\u002F15.keyboard-shortcuts",{"title":97,"path":98,"stem":99},"Privacy and security","\u002Fguide\u002Fprivacy-and-security","2.guide\u002F16.privacy-and-security",{"title":101,"icon":102,"path":103,"stem":104,"children":105,"page":29},"Reference","i-lucide-square-terminal","\u002Freference","3.reference",[106,110,114,118,122,126,130],{"title":107,"path":108,"stem":109},"Command line","\u002Freference\u002Fcli","3.reference\u002F1.cli",{"title":111,"path":112,"stem":113},"Automation tools","\u002Freference\u002Fautomation-tools","3.reference\u002F2.automation-tools",{"title":115,"path":116,"stem":117},"Scripting API","\u002Freference\u002Fscripting-api","3.reference\u002F3.scripting-api",{"title":119,"path":120,"stem":121},"Dynamic variables","\u002Freference\u002Fdynamic-variables","3.reference\u002F4.dynamic-variables",{"title":123,"path":124,"stem":125},"UI control channel","\u002Freference\u002Fui-control-channel","3.reference\u002F5.ui-control-channel",{"title":127,"path":128,"stem":129},"Workspace format","\u002Freference\u002Fworkspace-format","3.reference\u002F6.workspace-format",{"title":131,"path":132,"stem":133},"Feature status","\u002Freference\u002Ffeature-status","3.reference\u002F7.feature-status",{"title":135,"icon":136,"path":137,"stem":138,"children":139,"page":29},"Contributing","i-lucide-git-pull-request","\u002Fcontributing","4.contributing",[140,144,148,152,156,160,164,168],{"title":141,"path":142,"stem":143},"Contributing overview","\u002Fcontributing\u002Foverview","4.contributing\u002F1.overview",{"title":145,"path":146,"stem":147},"Development","\u002Fcontributing\u002Fdevelopment","4.contributing\u002F2.development",{"title":149,"path":150,"stem":151},"Architecture","\u002Fcontributing\u002Farchitecture","4.contributing\u002F3.architecture",{"title":153,"path":154,"stem":155},"Known gaps","\u002Fcontributing\u002Fgaps","4.contributing\u002F4.gaps",{"title":157,"path":158,"stem":159},"Adding a feature","\u002Fcontributing\u002Fadding-a-feature","4.contributing\u002F5.adding-a-feature",{"title":161,"path":162,"stem":163},"Assets and clean-room","\u002Fcontributing\u002Fassets-and-clean-room","4.contributing\u002F6.assets-and-clean-room",{"title":165,"path":166,"stem":167},"Releasing","\u002Fcontributing\u002Freleasing","4.contributing\u002F7.releasing",{"title":169,"path":170,"stem":171},"Writing the documentation","\u002Fcontributing\u002Fdocumentation","4.contributing\u002F8.documentation",{"id":173,"title":26,"body":174,"description":633,"extension":634,"links":635,"meta":636,"navigation":637,"path":27,"seo":638,"stem":28,"__hash__":639},"docs\u002F1.getting-started\u002F5.troubleshooting.md",{"type":175,"value":176,"toc":620},"minimark",[177,182,186,223,227,230,244,253,257,264,274,293,297,300,323,326,338,346,350,429,433,450,472,477,481,487,505,509,512,523,527,542,546,550,553,610],[178,179,181],"h2",{"id":180},"macos-says-the-app-could-not-be-verified","macOS says the app could not be verified",[183,184,185],"p",{},"Release builds are not notarized, so Gatekeeper blocks a file you downloaded in a browser. Do one of these:",[187,188,189,198,209],"ul",{},[190,191,192,193,197],"li",{},"Remove the quarantine flag: ",[194,195,196],"code",{},"xattr -dr com.apple.quarantine \u002FApplications\u002FPostguy.app",".",[190,199,200,201,205,206,197],{},"Open ",[202,203,204],"strong",{},"System Settings → Privacy & Security"," and choose ",[202,207,208],{},"Open Anyway",[190,210,211,212,215,216,219,220,197],{},"Download with ",[194,213,214],{},"curl"," and unpack with ",[194,217,218],{},"ditto",", which never sets the flag. The commands are on ",[221,222,15],"a",{"href":16},[178,224,226],{"id":225},"windows-shows-windows-protected-your-pc","Windows shows \"Windows protected your PC\"",[183,228,229],{},"The installer is not signed, so SmartScreen warns you.",[231,232,233,239],"ol",{},[190,234,235,236,197],{},"Choose ",[202,237,238],{},"More info",[190,240,235,241,197],{},[202,242,243],{},"Run anyway",[183,245,246,247,250,251,197],{},"To be sure of the file, check it against ",[194,248,249],{},"SHA256SUMS.txt"," first. See ",[221,252,15],{"href":16},[178,254,256],{"id":255},"workspace-already-open-by-pid","\"workspace already open by pid …\"",[183,258,259,260,263],{},"A workspace can be open in only one process at a time. Opening it takes a lock file at ",[194,261,262],{},"\u003Cworkspace>\u002F.postguy\u002Flock",". The file holds the process id and a start time. The full message is:",[265,266,272],"pre",{"className":267,"code":269,"language":270,"meta":271},[268],"language-text","workspace already open by pid 1234; close that instance or remove \u003Cworkspace>\u002F.postguy\u002Flock if it is gone\n","text","",[194,273,269],{"__ignoreMap":271},[231,275,276,283,286],{},[190,277,278,279,282],{},"Close the other Postguy window, or stop the ",[194,280,281],{},"postguy-cli"," command that has the workspace open.",[190,284,285],{},"If Postguy crashed, start it again. A lock is taken over automatically when its process no longer exists or the lock is older than three minutes.",[190,287,288,289,292],{},"If a process was killed and the message persists, delete the ",[194,290,291],{},"lock"," file by hand.",[178,294,296],{"id":295},"a-file-was-corrupt","A file was corrupt",[183,298,299],{},"Postguy never silently drops or repairs a data file.",[187,301,302,309,316],{},[190,303,304,305,308],{},"If a document, settings or session file can't be read, Postguy renames it next to the original as ",[194,306,307],{},"\u003Cname>.corrupt-\u003Ctime>",". The app starts with a default in its place and shows a note (for settings: \"settings file corrupt; moved to …\").",[190,310,311,312,315],{},"A ",[194,313,314],{},".corrupt-\u003Ctime>"," file is kept for you to inspect or repair. Postguy does not read it again.",[190,317,318,319,322],{},"Every save is atomic. The previous version is kept as ",[194,320,321],{},"\u003Cname>.bak",", one generation deep.",[183,324,325],{},"To go back to the previous version:",[231,327,328,331],{},[190,329,330],{},"Close Postguy.",[190,332,333,334,337],{},"Copy the ",[194,335,336],{},".bak"," file over the file.",[183,339,340,341,343,344,197],{},"See ",[221,342,41],{"href":42}," and ",[221,345,127],{"href":128},[178,347,349],{"id":348},"tls-or-certificate-errors","TLS or certificate errors",[351,352,353,366],"table",{},[354,355,356],"thead",{},[357,358,359,363],"tr",{},[360,361,362],"th",{},"Symptom",[360,364,365],{},"What to check",[367,368,369,392,407],"tbody",{},[357,370,371,375],{},[372,373,374],"td",{},"Certificate not trusted for a private CA or a self-signed server",[372,376,377,379,380,383,384,387,388,391],{},[202,378,89],{}," (",[194,381,382],{},"Cmd\u002FCtrl+,",") → ",[202,385,386],{},"Certificates"," → ",[202,389,390],{},"Custom CA bundle (PEM)",". The file is added to the system roots for every request.",[357,393,394,397],{},[372,395,396],{},"A client certificate is rejected or not read",[372,398,399,387,401,387,403,406],{},[202,400,89],{},[202,402,386],{},[202,404,405],{},"Client certificate",". Give a PEM chain and a PEM private key (PKCS#8, PKCS#1 or SEC1). Encrypted keys and PFX files are not supported yet.",[357,408,409,412],{},[372,410,411],{},"You need to test a server with an invalid certificate",[372,413,414,415,418,419,421,422,425,426,428],{},"Turn off ",[202,416,417],{},"SSL certificate verification"," in ",[202,420,89],{},", or turn on ",[202,423,424],{},"Enable SSL certificate verification"," in a single request's ",[202,427,89],{}," tab. Turn it back on afterwards. With verification off, any server can impersonate the one you meant to reach.",[178,430,432],{"id":431},"requests-fail-behind-a-proxy","Requests fail behind a proxy",[183,434,435,436,439,440,439,443,343,446,449],{},"By default Postguy uses the system proxy settings. It reads the ",[194,437,438],{},"HTTP_PROXY",", ",[194,441,442],{},"HTTPS_PROXY",[194,444,445],{},"ALL_PROXY",[194,447,448],{},"NO_PROXY"," environment variables (upper or lower case).",[187,451,452,455,469],{},[190,453,454],{},"A graphical launcher may not pass your shell's variables to the app. Start Postguy from a terminal to test.",[190,456,457,458,461,462,418,465,468],{},"Or set ",[202,459,460],{},"Proxy mode"," to ",[202,463,464],{},"Custom proxy",[202,466,467],{},"Settings → Proxy",". A custom proxy wins over the environment.",[190,470,471],{},"The Console logs the proxy a request actually used.",[183,473,474,475,197],{},"Details: ",[221,476,85],{"href":86},[178,478,480],{"id":479},"file-dialogs-do-not-open-on-linux-or-freebsd","File dialogs do not open on Linux or FreeBSD",[183,482,483,484,197],{},"Open and Save dialogs use ",[194,485,486],{},"xdg-desktop-portal",[187,488,489,492,502],{},[190,490,491],{},"Install it and a backend that matches your desktop.",[190,493,494,495,498,499,501],{},"The ",[194,496,497],{},".deb"," lists ",[194,500,486],{}," as a recommended package.",[190,503,504],{},"In the Flatpak build, dialogs always go through the portal because the sandbox has no filesystem access.",[178,506,508],{"id":507},"the-window-does-not-start-on-linux","The window does not start on Linux",[183,510,511],{},"Postguy loads X11 or Wayland, xkbcommon and EGL\u002FGL libraries at run time.",[231,513,514,520],{},[190,515,516,517,519],{},"Check that the libraries listed under Linux on ",[221,518,15],{"href":16}," are installed.",[190,521,522],{},"Start the app from a terminal so you can see any error message.",[178,524,526],{"id":525},"scripts-do-nothing","Scripts do nothing",[231,528,529,539],{},[190,530,200,531,534,535,538],{},[202,532,533],{},"Settings → General"," and check that ",[202,536,537],{},"Disable scripts"," is off. When it is on, pre-request and post-response scripts are skipped for every request and run.",[190,540,541],{},"Remember that scripts run only for HTTP requests, not gRPC or WebSocket.",[183,543,340,544,197],{},[221,545,61],{"href":62},[178,547,549],{"id":548},"where-to-look-for-diagnostics","Where to look for diagnostics",[183,551,552],{},"Postguy writes no log file. Look here instead:",[187,554,555,572,578,584,590],{},[190,556,557,560,561,563,564,567,568,571],{},[202,558,559],{},"Console",": click ",[202,562,559],{}," at the bottom left, or press ",[194,565,566],{},"Cmd\u002FCtrl+Alt+C",". It lists request summaries, logs, warnings and errors. Script ",[194,569,570],{},"console.log"," output appears here. Filters: All, Requests, Logs, Warnings, Errors.",[190,573,574,577],{},[202,575,576],{},"Status line",": the text at the bottom right of the window shows the result of the last action (\"Ready\", \"Created request\", and error messages).",[190,579,580,583],{},[202,581,582],{},"Import report",": after an import, the report lists what was changed, skipped or unsupported.",[190,585,586,589],{},[202,587,588],{},"Terminal",": messages that can't be shown in the window, such as \"control channel disabled\", go to standard error. Start the app from a terminal to see them.",[190,591,592,595,596,598,599,602,603,606,607,197],{},[202,593,594],{},"CLI",": ",[194,597,281],{}," prints errors to standard error. It exits ",[194,600,601],{},"1"," for a failure and ",[194,604,605],{},"2"," for a usage error. See the ",[221,608,609],{"href":108},"CLI reference",[183,611,612,613,619],{},"If none of this helps, open an issue at ",[221,614,618],{"href":615,"rel":616},"https:\u002F\u002Fgithub.com\u002Fzuramai\u002Fpostguy\u002Fissues",[617],"nofollow","github.com\u002Fzuramai\u002Fpostguy\u002Fissues",". Never paste real tokens, API keys or private responses.",{"title":271,"searchDepth":621,"depth":621,"links":622},2,[623,624,625,626,627,628,629,630,631,632],{"id":180,"depth":621,"text":181},{"id":225,"depth":621,"text":226},{"id":255,"depth":621,"text":256},{"id":295,"depth":621,"text":296},{"id":348,"depth":621,"text":349},{"id":431,"depth":621,"text":432},{"id":479,"depth":621,"text":480},{"id":507,"depth":621,"text":508},{"id":525,"depth":621,"text":526},{"id":548,"depth":621,"text":549},"Fixes for OS warnings on first launch, a locked or corrupt workspace, TLS and proxy errors, missing file dialogs, and where to look for diagnostics.","md",null,{},true,{"title":26,"description":633},"rPmaRdkdZiBIc_vvWPfrYiyClk4F2Xdg6hnZqudcwzA",[641,643],{"title":22,"path":23,"stem":24,"description":642,"children":-1},"Build the Postguy desktop app and the postguy-cli binary with Cargo on macOS, Windows, Linux and FreeBSD.",{"title":37,"path":38,"stem":39,"description":644,"children":-1},"The Postguy window: header, sidebar, tabs, bottom bar, command palette, menus, themes and zoom.",1793179613009]