[{"data":1,"prerenderedAt":249},["ShallowReactive",2],{"content-en-\u002Fguide\u002Fgetting-started":3},{"id":4,"title":5,"body":6,"description":108,"extension":241,"jsonLd":242,"meta":243,"navigation":244,"path":245,"schemaRole":242,"seo":246,"stem":247,"__hash__":248},"content_en\u002Fguide\u002Fgetting-started.md","Getting Started",{"type":7,"value":8,"toc":230},"minimark",[9,13,18,47,50,54,57,82,87,99,102,123,127,138,146,156,160,163,176,179,188,191,206,210,226],[10,11,5],"h1",{"id":12},"getting-started",[14,15,17],"h2",{"id":16},"what-is-bwsf","What is bwsf?",[19,20,21,25,26,33,34,38,39,42,43,46],"p",{},[22,23,24],"strong",{},"bwsf"," is a CLI tool that uses ",[27,28,32],"a",{"href":29,"rel":30},"https:\u002F\u002Fbitwarden.com\u002F",[31],"nofollow","Bitwarden"," to manage project files such as ",[35,36,37],"code",{},".env*"," and Terraform ",[35,40,41],{},"*.tfvars"," \u002F ",[35,44,45],{},"*.tfvars.json"," securely.",[19,48,49],{},"Instead of sharing secrets through insecure channels like email or Slack, bwsf lets you store them in your Bitwarden vault and sync them across your team.",[14,51,53],{"id":52},"prerequisites","Prerequisites",[19,55,56],{},"Before using bwsf, make sure you have:",[58,59,60,72],"ol",{},[61,62,63,66,67,71],"li",{},[22,64,65],{},"Bitwarden Account"," - Either ",[27,68,70],{"href":29,"rel":69},[31],"Bitwarden Cloud"," or a self-hosted Bitwarden server",[61,73,74,81],{},[22,75,76,77,80],{},"Bitwarden CLI (",[35,78,79],{},"bw",")"," - The official Bitwarden command-line tool",[83,84,86],"h3",{"id":85},"installing-bitwarden-cli","Installing Bitwarden CLI",[19,88,89,90,95,96,98],{},"Follow the ",[27,91,94],{"href":92,"rel":93},"https:\u002F\u002Fbitwarden.com\u002Fhelp\u002Fcli\u002F#download-and-install",[31],"official Bitwarden CLI installation guide"," to install the ",[35,97,79],{}," command on your machine.",[19,100,101],{},"Verify the installation:",[103,104,109],"pre",{"className":105,"code":106,"language":107,"meta":108,"style":108},"language-bash shiki shiki-themes github-dark-high-contrast","bw --version\n","bash","",[35,110,111],{"__ignoreMap":108},[112,113,116,119],"span",{"class":114,"line":115},"line",1,[112,117,79],{"class":118},"s_sBn",[112,120,122],{"class":121},"sCcAr"," --version\n",[14,124,126],{"id":125},"how-bwsf-works","How bwsf Works",[19,128,129,130,133,134,137],{},"bwsf stores managed files as ",[22,131,132],{},"Note items"," in a Bitwarden folder (default name: ",[35,135,136],{},"dotenvs","). Here's how the structure looks:",[103,139,144],{"className":140,"code":142,"language":143},[141],"language-text","Bitwarden Vault\n└── dotenvs\u002F                    # Default folder for bwsf (configurable)\n    ├── my-web-app              # Project name = current directory name\n    │   ├── .env\n    │   ├── .env.staging\n    │   ├── .env.production\n    │   └── terraform.tfvars\n    └── another-project\n        └── .env\n","text",[35,145,142],{"__ignoreMap":108},[19,147,148,149,151,152,155],{},"::: info\nBy default the folder name is ",[35,150,136],{},". You can change it with ",[35,153,154],{},"bwsf setup --folder \u003Cname>",". Changing the name does not move existing notes.\n:::",[14,157,159],{"id":158},"initial-setup","Initial Setup",[19,161,162],{},"After installing bwsf, run the setup command:",[103,164,166],{"className":105,"code":165,"language":107,"meta":108,"style":108},"bwsf setup\n",[35,167,168],{"__ignoreMap":108},[112,169,170,172],{"class":114,"line":115},[112,171,24],{"class":118},[112,173,175],{"class":174},"sTRMh"," setup\n",[19,177,178],{},"This will configure:",[180,181,182,185],"ul",{},[61,183,184],{},"Your Bitwarden server URL (for self-hosted instances)",[61,186,187],{},"Your Bitwarden account credentials",[19,189,190],{},"Check the saved values any time with:",[103,192,194],{"className":105,"code":193,"language":107,"meta":108,"style":108},"bwsf config show\n",[35,195,196],{"__ignoreMap":108},[112,197,198,200,203],{"class":114,"line":115},[112,199,24],{"class":118},[112,201,202],{"class":174}," config",[112,204,205],{"class":174}," show\n",[14,207,209],{"id":208},"next-steps","Next Steps",[180,211,212,219],{},[61,213,214,218],{},[27,215,217],{"href":216},"\u002Fen\u002Fguide\u002Finstallation","Install bwsf"," - Installation instructions for your platform",[61,220,221,225],{},[27,222,224],{"href":223},"\u002Fen\u002Fguide\u002Fcommands","Commands"," - Learn all available commands",[227,228,229],"style",{},"html pre.shiki code .s_sBn, html code.shiki .s_sBn{--shiki-default:#FFB757}html pre.shiki code .sCcAr, html code.shiki .sCcAr{--shiki-default:#91CBFF}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 pre.shiki code .sTRMh, html code.shiki .sTRMh{--shiki-default:#ADDCFF}",{"title":108,"searchDepth":231,"depth":231,"links":232},2,[233,234,238,239,240],{"id":16,"depth":231,"text":17},{"id":52,"depth":231,"text":53,"children":235},[236],{"id":85,"depth":237,"text":86},3,{"id":125,"depth":231,"text":126},{"id":158,"depth":231,"text":159},{"id":208,"depth":231,"text":209},"md",null,{},true,"\u002Fguide\u002Fgetting-started",{"title":5,"description":108},"guide\u002Fgetting-started","5iPfZqdJepgvIvEFOX2vWsEta7AFLvn7ohDpauwIMgE",1788146015977]