[{"data":1,"prerenderedAt":738},["ShallowReactive",2],{"navigation":3,"\u002Fdocs\u002Fbancwr\u002Furls":148,"\u002Fdocs\u002Fbancwr\u002Furls-surround":735},[4,19,62,93],{"title":5,"path":6,"stem":7,"children":8,"icon":10},"Getting Started","\u002Fdocs\u002Fgetting-started","1.docs\u002F1.getting-started\u002F1.index",[9,11,15],{"title":5,"path":6,"stem":7,"icon":10},"i-lucide-rocket",{"title":12,"path":13,"stem":14},"Installation","\u002Fdocs\u002Fgetting-started\u002Finstallation","1.docs\u002F1.getting-started\u002F2.installation",{"title":16,"path":17,"stem":18},"Using Diogel","\u002Fdocs\u002Fgetting-started\u002Fusage","1.docs\u002F1.getting-started\u002F3.usage",{"title":20,"path":21,"stem":22,"children":23,"icon":61},"Porwr","\u002Fdocs\u002Fporwr","1.docs\u002F2.porwr\u002F01.index",[24,26,29,33,37,41,45,49,53,57],{"title":25,"path":21,"stem":22,"icon":10},"What is Porwr",{"title":12,"path":27,"stem":28},"\u002Fdocs\u002Fporwr\u002Finstallation","1.docs\u002F2.porwr\u002F02.installation",{"title":30,"path":31,"stem":32},"Dashboard","\u002Fdocs\u002Fporwr\u002Fdashboard","1.docs\u002F2.porwr\u002F03.dashboard",{"title":34,"path":35,"stem":36},"Key Management","\u002Fdocs\u002Fporwr\u002Fkeys","1.docs\u002F2.porwr\u002F04.keys",{"title":38,"path":39,"stem":40},"Profile Management","\u002Fdocs\u002Fporwr\u002Fprofile","1.docs\u002F2.porwr\u002F05.profile",{"title":42,"path":43,"stem":44},"Relay Management","\u002Fdocs\u002Fporwr\u002Frelay","1.docs\u002F2.porwr\u002F06.relay",{"title":46,"path":47,"stem":48},"Messaging","\u002Fdocs\u002Fporwr\u002Fmessaging","1.docs\u002F2.porwr\u002F07.messaging",{"title":50,"path":51,"stem":52},"Media Management","\u002Fdocs\u002Fporwr\u002Fmedia","1.docs\u002F2.porwr\u002F08.media",{"title":54,"path":55,"stem":56},"Wallet Management","\u002Fdocs\u002Fporwr\u002Fwallet","1.docs\u002F2.porwr\u002F09.wallet",{"title":58,"path":59,"stem":60},"Extension Settings","\u002Fdocs\u002Fporwr\u002Fsettings","1.docs\u002F2.porwr\u002F10.settings","i-lucide-puzzle",{"title":63,"path":64,"stem":65,"children":66,"icon":92},"Symudol","\u002Fdocs\u002Fsymudol","1.docs\u002F3.symudol\u002F1.index",[67,69,72,76,80,84,88],{"title":68,"path":64,"stem":65,"icon":10},"What is Symudol",{"title":12,"path":70,"stem":71},"\u002Fdocs\u002Fsymudol\u002Finstallation","1.docs\u002F3.symudol\u002F2.installation",{"title":73,"path":74,"stem":75},"Your vault","\u002Fdocs\u002Fsymudol\u002Fvault","1.docs\u002F3.symudol\u002F3.vault",{"title":77,"path":78,"stem":79},"Accounts and profile","\u002Fdocs\u002Fsymudol\u002Faccounts","1.docs\u002F3.symudol\u002F4.accounts",{"title":81,"path":82,"stem":83},"Approving requests","\u002Fdocs\u002Fsymudol\u002Fapproving-requests","1.docs\u002F3.symudol\u002F5.approving-requests",{"title":85,"path":86,"stem":87},"Remote apps (NIP-46)","\u002Fdocs\u002Fsymudol\u002Fremote-apps","1.docs\u002F3.symudol\u002F6.remote-apps",{"title":89,"path":90,"stem":91},"Settings","\u002Fdocs\u002Fsymudol\u002Fsettings","1.docs\u002F3.symudol\u002F7.settings","i-lucide-smartphone",{"title":94,"path":95,"stem":96,"children":97,"icon":147},"Bancwr","\u002Fdocs\u002Fbancwr","1.docs\u002F4.bancwr\u002F01.index",[98,100,103,107,111,115,119,123,127,131,135,139,143],{"title":99,"path":95,"stem":96,"icon":10},"What is Bancwr",{"title":12,"path":101,"stem":102},"\u002Fdocs\u002Fbancwr\u002Finstallation","1.docs\u002F4.bancwr\u002F02.installation",{"title":104,"path":105,"stem":106},"Configuring the URLs","\u002Fdocs\u002Fbancwr\u002Furls","1.docs\u002F4.bancwr\u002F03.urls",{"title":108,"path":109,"stem":110},"First administrator and signing in","\u002Fdocs\u002Fbancwr\u002Ffirst-administrator","1.docs\u002F4.bancwr\u002F04.first-administrator",{"title":112,"path":113,"stem":114},"Protecting the bunker key","\u002Fdocs\u002Fbancwr\u002Fprotecting-the-key","1.docs\u002F4.bancwr\u002F05.protecting-the-key",{"title":116,"path":117,"stem":118},"Team and roles","\u002Fdocs\u002Fbancwr\u002Fteam","1.docs\u002F4.bancwr\u002F06.team",{"title":120,"path":121,"stem":122},"Signing identities","\u002Fdocs\u002Fbancwr\u002Fsigning-identities","1.docs\u002F4.bancwr\u002F07.signing-identities",{"title":124,"path":125,"stem":126},"Connecting apps","\u002Fdocs\u002Fbancwr\u002Fconnecting-apps","1.docs\u002F4.bancwr\u002F08.connecting-apps",{"title":128,"path":129,"stem":130},"Approval before signing","\u002Fdocs\u002Fbancwr\u002Fapproval-before-signing","1.docs\u002F4.bancwr\u002F09.approval-before-signing",{"title":132,"path":133,"stem":134},"Profile, follows and relays","\u002Fdocs\u002Fbancwr\u002Fprofile-follows-relays","1.docs\u002F4.bancwr\u002F10.profile-follows-relays",{"title":136,"path":137,"stem":138},"Health, versions and logs","\u002Fdocs\u002Fbancwr\u002Fhealth-and-logs","1.docs\u002F4.bancwr\u002F11.health-and-logs",{"title":140,"path":141,"stem":142},"Backup and restore","\u002Fdocs\u002Fbancwr\u002Fbackup-and-restore","1.docs\u002F4.bancwr\u002F12.backup-and-restore",{"title":144,"path":145,"stem":146},"Updating","\u002Fdocs\u002Fbancwr\u002Fupdating","1.docs\u002F4.bancwr\u002F13.updating","i-lucide-server",{"id":149,"title":104,"body":150,"description":449,"extension":729,"meta":730,"navigation":731,"path":105,"seo":732,"stem":106,"__hash__":734},"docs\u002F1.docs\u002F4.bancwr\u002F03.urls.md",{"type":151,"value":152,"toc":712},"minimark",[153,158,162,240,244,252,265,279,284,294,316,320,326,332,338,368,377,381,393,408,418,427,431,442,452,455,473,476,480,491,527,530,537,544,553,576,581,595,599,605,617,621,630,640,664,668,675,699,708],[154,155,157],"h2",{"id":156},"the-three-addresses","The three addresses",[159,160,161],"p",{},"Bancwr uses three addresses. Each one is set in a different place:",[163,164,165,181],"table",{},[166,167,168],"thead",{},[169,170,171,175,178],"tr",{},[172,173,174],"th",{},"Address",[172,176,177],{},"Who uses it",[172,179,180],{},"Set by",[182,183,184,206,225],"tbody",{},[169,185,186,194,197],{},[187,188,189,190],"td",{},"The console's public address, such as ",[191,192,193],"code",{},"https:\u002F\u002Fbancwr.example",[187,195,196],{},"People signing in, and apps waiting for an approval",[187,198,199,202,203],{},[191,200,201],{},"NUXT_SITE_ORIGIN"," in ",[191,204,205],{},".env",[169,207,208,214,217],{},[187,209,210,211],{},"The bunker's internal address, ",[191,212,213],{},"http:\u002F\u002Fbunker:3000",[187,215,216],{},"The console, and nothing else",[187,218,219,202,222],{},[191,220,221],{},"NUXT_API_BASE",[191,223,224],{},"compose.yaml",[169,226,227,234,237],{},[187,228,229,230,233],{},"The ",[191,231,232],{},"bunker:\u002F\u002F"," connection string",[187,235,236],{},"Nostr apps connecting over NIP-46",[187,238,239],{},"The bunker's key and its relays",[154,241,243],{"id":242},"the-consoles-public-address","The console's public address",[159,245,246,248,249,251],{},[191,247,201],{}," is the HTTPS address people open Bancwr on, such as ",[191,250,193],{},".",[253,254,255,259,262],"ul",{},[256,257,258],"li",{},"Give the scheme and the host, and a port if it is not the default. No path, and no trailing slash.",[256,260,261],{},"It must be exactly the address in the browser's address bar.",[256,263,264],{},"Compose refuses to start without it.",[159,266,267,268,271,272,275,276,251],{},"Compose also passes it to the bunker as ",[191,269,270],{},"BANCWR_CONSOLE_URL",". When an app asks for a signature that needs an administrator's approval, the bunker points the app at that address, at ",[191,273,274],{},"\u002Fapprovals\u002F\u003Cid>",". See ",[277,278,128],"a",{"href":129},[280,281,283],"h3",{"id":282},"why-sign-in-needs-https","Why sign-in needs HTTPS",[159,285,286,287,290,291,251],{},"The console's sign-in cookie is ",[191,288,289],{},"Secure",", so browsers only send it over HTTPS, or to ",[191,292,293],{},"http:\u002F\u002Flocalhost",[253,295,296,309],{},[256,297,298,299,301,302,305,306,251],{},"The console refuses to start if ",[191,300,201],{}," is plain ",[191,303,304],{},"http:\u002F\u002F"," for any other host. Its log says: ",[191,307,308],{},"NUXT_SITE_ORIGIN must be https:\u002F\u002F (http:\u002F\u002F is allowed only for localhost)",[256,310,311,312,315],{},"For testing on one machine, ",[191,313,314],{},"NUXT_SITE_ORIGIN=http:\u002F\u002Flocalhost:3001"," works without TLS.",[280,317,319],{"id":318},"this-pages-address-does-not-match","\"This page's address does not match\"",[159,321,322,323,325],{},"Each sign-in event names the console's address, and the console refuses one that names another address. If you open Bancwr at any address other than ",[191,324,201],{},", the sign-in page says:",[327,328,329],"blockquote",{},[159,330,331],{},"This page's address does not match the address Bancwr is configured with (NUXT_SITE_ORIGIN).",[159,333,334,335,337],{},"To fix it, open Bancwr at exactly the address in ",[191,336,201],{},". Look for:",[253,339,340,350,356,363],{},[256,341,342,345,346,349],{},[191,343,344],{},"http"," against ",[191,347,348],{},"https",",",[256,351,352,355],{},[191,353,354],{},"www."," on one and not the other,",[256,357,358,359,362],{},"a port, such as ",[191,360,361],{},":3001",", on one and not the other,",[256,364,365,366,251],{},"a trailing slash or a path in ",[191,367,201],{},[159,369,370,371,373,374,251],{},"If you change the address people use, change ",[191,372,201],{}," to match and recreate both containers with ",[191,375,376],{},"podman compose up -d",[154,378,380],{"id":379},"how-the-console-reaches-the-bunker","How the console reaches the bunker",[159,382,383,384,386,387,389,390,392],{},"The console talks to the bunker over the compose network, at ",[191,385,213],{},". ",[191,388,224],{}," sets this as ",[191,391,221],{}," on the console. You do not need to change it.",[253,394,395,398,401],{},[256,396,397],{},"The bunker's port is never published on the host. Only the console reaches it.",[256,399,400],{},"Only the console goes behind your reverse proxy. Never expose the bunker's API directly.",[256,402,403,404,407],{},"The bunker answers only requests the console has signed with ",[191,405,406],{},"BANCWR_PROXY_SECRET",", naming the signed-in key. It checks that key's role on every request. The bunker does not start without the secret.",[159,409,410,411,413,414,417],{},"If you run the console image outside compose, set ",[191,412,221],{}," to the bunker's address yourself. Its default, ",[191,415,416],{},"http:\u002F\u002Flocalhost:3000",", is the console's own port inside its container, so it will not reach the bunker.",[159,419,420,421,423,424,426],{},"To change ",[191,422,406],{},", set a new value in ",[191,425,205],{}," and recreate both containers. Compose passes the one value to both.",[154,428,430],{"id":429},"the-connection-string-apps-use","The connection string apps use",[159,432,433,434,436,437,441],{},"Apps connect to the bunker with a ",[191,435,232],{}," connection string, which an administrator issues as a connection token under ",[438,439,440],"strong",{},"Connections",". NIP-46 defines its form:",[443,444,450],"pre",{"className":445,"code":447,"language":448,"meta":449},[446],"language-text","bunker:\u002F\u002F\u003Cbunker public key in hex>?relay=wss:\u002F\u002Frelay.one&relay=wss:\u002F\u002Frelay.two&secret=\u003Ctoken secret>\n","text","",[191,451,447],{"__ignoreMap":449},[159,453,454],{},"It is built from:",[253,456,457,463,470],{},[256,458,459,460,462],{},"the public key of the identity the token signs as: the bunker's own key, or another identity it holds (see ",[277,461,120],{"href":121},"),",[256,464,465,466,469],{},"every relay in the bunker's relay list, one ",[191,467,468],{},"relay="," for each,",[256,471,472],{},"the token's secret, shown once.",[159,474,475],{},"There is no URL for the bunker on the internet. Apps and the bunker meet on the relays.",[280,477,479],{"id":478},"choosing-the-bunkers-relays","Choosing the bunker's relays",[159,481,482,483,486,487,490],{},"After you first sign in, choose the relays under ",[438,484,485],{},"Config",", ",[438,488,489],{},"Bunker relays",":",[253,492,493,503,506,520],{},[256,494,495,496,499,500,251],{},"Search the known relays, from reports that relay monitors publish (NIP-66), or enter an address under ",[438,497,498],{},"Add a relay"," and click ",[438,501,502],{},"Add",[256,504,505],{},"Choose 1 to 6 relays. 2 or more is advised, so one relay going down does not cut apps off.",[256,507,508,509,512,513,516,517,251],{},"Addresses must be ",[191,510,511],{},"wss:\u002F\u002F",". Plain ",[191,514,515],{},"ws:\u002F\u002F"," is accepted only for ",[191,518,519],{},"localhost",[256,521,522,523,526],{},"Click ",[438,524,525],{},"Save relays",". The bunker uses the new list straight away, without a restart.",[159,528,529],{},"The list is kept in the bunker's database. It is never published to Nostr, and it is not the same as any member's own relay list.",[159,531,532,533,536],{},"Until there is at least 1 relay, the ",[438,534,535],{},"Relays"," health check is red and no token can be issued.",[280,538,540,541],{"id":539},"fixing-the-relays-with-nip46_relays","Fixing the relays with ",[191,542,543],{},"NIP46_RELAYS",[159,545,546,547,549,550,552],{},"To set the relays in ",[191,548,205],{}," instead, set ",[191,551,543],{}," to a comma-separated list:",[443,554,558],{"className":555,"code":556,"language":557,"meta":449,"style":449},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","NIP46_RELAYS=wss:\u002F\u002Frelay.nsec.app,wss:\u002F\u002Frelay.damus.io\n","bash",[191,559,560],{"__ignoreMap":449},[561,562,565,568,572],"span",{"class":563,"line":564},"line",1,[561,566,543],{"class":567},"sTEyZ",[561,569,571],{"class":570},"sMK4o","=",[561,573,575],{"class":574},"sfazB","wss:\u002F\u002Frelay.nsec.app,wss:\u002F\u002Frelay.damus.io\n",[159,577,578,579,251],{},"Then recreate the bunker with ",[191,580,376],{},[253,582,583,589],{},[256,584,585,586,588],{},"While it is set, it always decides. ",[438,587,489],{}," shows the list read-only, with each relay's status.",[256,590,591,592,594],{},"A list saved in the console is ignored, and kept. To manage the relays in the console again, unset ",[191,593,543],{}," and recreate the bunker.",[280,596,598],{"id":597},"when-the-relays-change","When the relays change",[159,600,601,602,604],{},"An app learns the bunker's relays from its ",[191,603,232],{}," string, and keeps using them.",[253,606,607,610],{},[256,608,609],{},"Adding a relay does not affect connected apps. New connection strings carry it.",[256,611,612,613,616],{},"Removing a relay an app uses cuts that app off. Before you save a removal, the console warns you and the button reads ",[438,614,615],{},"Save and remove",". The app must connect again with a new connection token, whose string carries the current list.",[154,618,620],{"id":619},"the-reverse-proxy","The reverse proxy",[159,622,623,624,627,628,251],{},"Put a TLS reverse proxy in front of the console, at ",[191,625,626],{},"127.0.0.1:3001",", for the host in ",[191,629,201],{},[159,631,632,633,639],{},"With ",[277,634,638],{"href":635,"rel":636},"https:\u002F\u002Fcaddyserver.com\u002F",[637],"nofollow","Caddy",", which obtains and renews certificates itself:",[443,641,645],{"className":642,"code":643,"language":644,"meta":449,"style":449},"language-caddy shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","bancwr.example {\n    reverse_proxy 127.0.0.1:3001\n}\n","caddy",[191,646,647,652,658],{"__ignoreMap":449},[561,648,649],{"class":563,"line":564},[561,650,651],{},"bancwr.example {\n",[561,653,655],{"class":563,"line":654},2,[561,656,657],{},"    reverse_proxy 127.0.0.1:3001\n",[561,659,661],{"class":563,"line":660},3,[561,662,663],{},"}\n",[280,665,667],{"id":666},"on-a-local-network-with-no-public-name","On a local network with no public name",[159,669,670,671,674],{},"Caddy cannot get a public certificate for a name only your network knows. Add ",[191,672,673],{},"tls internal"," to the block, and Caddy uses its own certificate authority:",[443,676,678],{"className":642,"code":677,"language":644,"meta":449,"style":449},"bancwr.lan {\n    tls internal\n    reverse_proxy 127.0.0.1:3001\n}\n",[191,679,680,685,690,694],{"__ignoreMap":449},[561,681,682],{"class":563,"line":564},[561,683,684],{},"bancwr.lan {\n",[561,686,687],{"class":563,"line":654},[561,688,689],{},"    tls internal\n",[561,691,692],{"class":563,"line":660},[561,693,657],{},[561,695,697],{"class":563,"line":696},4,[561,698,663],{},[159,700,701,702,704,705,251],{},"Each browser that opens Bancwr then has to trust Caddy's root certificate. Set ",[191,703,201],{}," to the same name, such as ",[191,706,707],{},"https:\u002F\u002Fbancwr.lan",[709,710,711],"style",{},"html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":449,"searchDepth":654,"depth":654,"links":713},[714,715,719,720,726],{"id":156,"depth":654,"text":157},{"id":242,"depth":654,"text":243,"children":716},[717,718],{"id":282,"depth":660,"text":283},{"id":318,"depth":660,"text":319},{"id":379,"depth":654,"text":380},{"id":429,"depth":654,"text":430,"children":721},[722,723,725],{"id":478,"depth":660,"text":479},{"id":539,"depth":660,"text":724},"Fixing the relays with NIP46_RELAYS",{"id":597,"depth":660,"text":598},{"id":619,"depth":654,"text":620,"children":727},[728],{"id":666,"depth":660,"text":667},"md",{},true,{"description":733,"title":104},"Set the addresses Bancwr uses: the console's public origin, how the console reaches the bunker, the bunker:\u002F\u002F string apps connect with, and the HTTPS reverse proxy.","sD2ml53u7z1UTxKGwpOjMsEcr59NDHvUxOWPKib04F0",[736,737],{"title":12,"path":101,"stem":102,"description":449,"children":-1},{"title":108,"path":109,"stem":110,"description":449,"children":-1},1795083908930]