From eb2e78c7ccfc9072aab41357859c6da707beb98c Mon Sep 17 00:00:00 2001 From: Chad Doty Date: Thu, 2 Apr 2026 10:57:35 -0400 Subject: [PATCH] first commit --- README.md | 39 +++++++++ images/bitwardenapp.svg | 13 +++ images/bitwardenextension.svg | 8 ++ images/bitwardeniosapp.svg | 8 ++ images/desktop-settings.svg | 19 +++++ images/extension-settings.svg | 20 +++++ images/mobile-settings.svg | 19 +++++ index.html | 150 ++++++++++++++++++++++++++++++++++ index.js | 19 +++++ style.css | 50 ++++++++++++ 10 files changed, 345 insertions(+) create mode 100644 README.md create mode 100644 images/bitwardenapp.svg create mode 100644 images/bitwardenextension.svg create mode 100644 images/bitwardeniosapp.svg create mode 100644 images/desktop-settings.svg create mode 100644 images/extension-settings.svg create mode 100644 images/mobile-settings.svg create mode 100644 index.html create mode 100644 index.js create mode 100644 style.css diff --git a/README.md b/README.md new file mode 100644 index 0000000..a9b6b9a --- /dev/null +++ b/README.md @@ -0,0 +1,39 @@ +# Documentation — Vault Warden (Bitwarden-compatible) + +Brief docs and quick-start for connecting Bitwarden clients and extensions to a self-hosted Vault Warden instance. + +**Live vault URL:** https://vault.depressionslair.com + +**Contents** +- What this repo provides +- How to preview locally +- How to configure clients and extensions +- Notes for contributors + +**What this repo provides** +- A simple documentation web page (index.html) with step-by-step instructions for signing up, signing in, and pointing Bitwarden clients/extensions at your Vault Warden server. +- Small illustrative SVG screenshots in `images/` used to show where to set the Server URL. + +**Preview locally** +1. Open a terminal in this repository root. +2. Start a quick HTTP server (Python 3): + +```bash +python -m http.server 8000 +``` + +3. Open http://localhost:8000 in your browser and view `index.html`. + +**Configure clients & extensions** +- Browser extensions: install Bitwarden extension, open extension → Settings → set Server URL to `https://vault.depressionslair.com`, then sign in. +- Desktop apps: open Bitwarden app → Settings → Advanced (or during login) set Server URL to `https://vault.depressionslair.com`. +- Mobile apps: open Bitwarden app → Settings → Server (or Sync) → set Server URL and sign in. + +If you want to change the default vault URL shown on the page, edit `index.html` and update the `href` / displayed URL near the top. + +**Contributing** +- Fix typos, improve instructions, or replace illustrative SVGs with real screenshots via pull requests. +- Images live in `images/`. + +**License** +This repository contains documentation and images; add a license file if you wish to apply one (e.g., MIT). diff --git a/images/bitwardenapp.svg b/images/bitwardenapp.svg new file mode 100644 index 0000000..9ad62b7 --- /dev/null +++ b/images/bitwardenapp.svg @@ -0,0 +1,13 @@ + + + + + + + + Change to Self hosted + + + + + diff --git a/images/bitwardenextension.svg b/images/bitwardenextension.svg new file mode 100644 index 0000000..80cd96a --- /dev/null +++ b/images/bitwardenextension.svg @@ -0,0 +1,8 @@ + + + + + + + + diff --git a/images/bitwardeniosapp.svg b/images/bitwardeniosapp.svg new file mode 100644 index 0000000..aab1cfc --- /dev/null +++ b/images/bitwardeniosapp.svg @@ -0,0 +1,8 @@ + + + + + + + + diff --git a/images/desktop-settings.svg b/images/desktop-settings.svg new file mode 100644 index 0000000..da714d3 --- /dev/null +++ b/images/desktop-settings.svg @@ -0,0 +1,19 @@ + + + + + + + Settings › Advanced + + Server URL: https://vault.depressionslair.com + Desktop app > Settings > Advanced > Server URL + + diff --git a/images/extension-settings.svg b/images/extension-settings.svg new file mode 100644 index 0000000..46226ac --- /dev/null +++ b/images/extension-settings.svg @@ -0,0 +1,20 @@ + + + + + + + + Server URL + + https://vault.depressionslair.com + Open the extension > Settings > Server URL + + diff --git a/images/mobile-settings.svg b/images/mobile-settings.svg new file mode 100644 index 0000000..5ba3eb0 --- /dev/null +++ b/images/mobile-settings.svg @@ -0,0 +1,19 @@ + + + + + + + + Server URL + https://vault.depressionslair.com + Mobile app › Settings › Server + + diff --git a/index.html b/index.html new file mode 100644 index 0000000..93e8c7b --- /dev/null +++ b/index.html @@ -0,0 +1,150 @@ + + + + + + Documentation - Vault Warden + + + + + +
+
+

Sign up & sign in — Vault Warden (Bitwarden-compatible)

+

Your vault URL: https://vault.depressionslair.com

+
+
+ +
+
+
+

Welcome to your Vault Warden documentation

+

Follow the quick steps below to create an account, sign in, and connect Bitwarden clients and browser extensions to Vault Warden.

+
+ +
+

1. Sign up (first time)

+
    +
  1. Open the vault URL in your browser: https://vault.depressionslair.com
    2. +
  2. Choose Create Account (or similar) on the web UI.
    3. +
  3. Enter your email, a strong master password, and any required information. Save a secure backup of your recovery code if shown.
    4. +
+
+ +
+

2. Sign in

+
    +
  1. Open the vault URL and click Log in.
    2. +
  2. Enter your email and master password.
    3. +
  3. If your server requires it, enter a 2FA code (TOTP) or use your configured second factor.
    4. +
+
+ +
+

3. Browser Extensions

+

Install official Bitwarden extensions and point them to your vault.

+ +
+ +
+

Browser extension — step-by-step

+

Below are step-by-step instructions for common browsers.

+

Chrome / Edge

+
    +
  1. Install the Bitwarden extension from the Chrome Web Store / Edge Add-ons.
    2. +
  2. Click the Bitwarden icon in your toolbar.
    3. +
  3. Open Accessing: > self hosted.
    4. +
  4. Find Server URL or Server field and enter https://vault.depressionslair.com.
    5. +
  5. Save and sign in with your account.
    6. +
+
+ Bitwarden browser extension settings showing Server URL field + Extension settings showing Server URL field +
Example: Change the Server URL inside the extension settings.
+
+ +

Firefox

+
    +
  1. Install the Bitwarden add-on from Mozilla Add-ons.
    2. +
  2. Go to Accessing: > self hosted.
    3. +
  3. Set the Server URL to https://vault.depressionslair.com, save, then sign in.
    4. +
+
+ +
+

Desktop apps — step-by-step

+
    +
  1. Download and install the Bitwarden desktop app for your OS from Bitwarden Downloads.
    2. +
  2. Open the app, go to Accessing: > self hosted.
    3. +
  3. Enter the Server URL: https://vault.depressionslair.com.
    4. +
  4. Save and sign in using your email and master password.
    5. +
+
+ Bitwarden desktop app login screen showing Server URL field + Desktop app settings showing Server URL field +
Example: Desktop app Advanced settings with Server URL highlighted.
+
+
+ +
+

Mobile apps — step-by-step (iOS & Android)

+
    +
  1. Install the Bitwarden app from the App Store (iOS) or Google Play (Android).
    2. +
  2. Open the app, go to Accessing: > self hosted.
    3. +
  3. Set the Server URL to https://vault.depressionslair.com and save.
    4. +
  4. Sign in with your credentials and enable biometrics if desired.
    5. +
+
+ Bitwarden mobile app login screen showing Server URL field + Mobile app settings showing Server URL field +
Example: Mobile settings where you set the Server URL.
+
+
+ +
+
+

Desktop Apps

+

Windows, macOS, Linux

+
    +
  • Download from Bitwarden Downloads.
    • +
  • Open app > Accessing: > self hosted > Server URL set to https://vault.depressionslair.com.
    • +
+
+ Bitwarden desktop app login screen showing Server URL field + Desktop app settings showing Server URL field +
Example: Desktop app Advanced settings with Server URL highlighted.
+
+
+ +
+

Mobile Apps

+

iOS & Android

+
    +
  • Install from the App Store or Google Play via Bitwarden Downloads.
    • +
  • Open app > Accessing: > self hosted > Server URL — enter https://vault.depressionslair.com and sign in.
    • +
+
+
+ +
+

Troubleshooting & Tips

+
    +
  • If the extension/app cannot connect, double-check the server URL and firewall rules.
    • +
  • Use a strong, unique master password and enable 2FA for extra security.
    • +
+
+ +
+

Need help? Contact your server administrator (EhChad).

+
+
+
+ + + + \ No newline at end of file diff --git a/index.js b/index.js new file mode 100644 index 0000000..58fe77d --- /dev/null +++ b/index.js @@ -0,0 +1,19 @@ +document.addEventListener('DOMContentLoaded', function(){ + const copyBtn = document.getElementById('copy-url'); + const vaultLink = document.getElementById('vault-link'); + if(copyBtn && vaultLink){ + copyBtn.addEventListener('click', async ()=>{ + try{ + await navigator.clipboard.writeText(vaultLink.href); + copyBtn.textContent = 'Copied!'; + setTimeout(()=> copyBtn.textContent = 'Copy', 1800); + }catch(e){ + const ta = document.createElement('textarea'); + ta.value = vaultLink.href; document.body.appendChild(ta); ta.select(); + try{ document.execCommand('copy'); copyBtn.textContent='Copied!'}catch(err){alert('Copy failed; please copy manually.')} + ta.remove(); setTimeout(()=> copyBtn.textContent = 'Copy',1800); + } + }); + } +}); + diff --git a/style.css b/style.css new file mode 100644 index 0000000..8382ad6 --- /dev/null +++ b/style.css @@ -0,0 +1,50 @@ +:root{ + --bg:#0f1724; + --card:#0b1220; + --accent:#6dd3f5; + --muted:#9aa4b2; + --glass: rgba(255,255,255,0.03); +} +*{box-sizing:border-box} +html,body{height:100%} +body{ + margin:0; + font-family:Inter,ui-sans-serif,system-ui,-apple-system,Segoe UI,Roboto,Helvetica,Arial; + background:linear-gradient(180deg,#071026 0%, #071a2a 60%); + color:#e6eef6; + -webkit-font-smoothing:antialiased; +} +.container{max-width:980px;margin:28px auto;padding:0 20px} +header{padding:28px 0} +header h1{margin:0;font-size:1.5rem} +.subtitle{margin:6px 0 0;color:var(--muted);font-size:0.95rem} +.subtitle a{color:var(--accent);text-decoration:underline} +#copy-url{margin-left:10px;padding:6px 8px;border-radius:6px;border:0;background:var(--accent);color:#072033;cursor:pointer} +.hero{background:linear-gradient(90deg, rgba(109,211,245,0.06), rgba(109,211,245,0.02));padding:18px;border-radius:10px;margin-bottom:18px} +.card{background:linear-gradient(180deg, rgba(255,255,255,0.02), rgba(255,255,255,0.01));border:1px solid rgba(255,255,255,0.03);padding:16px;border-radius:10px;margin-bottom:14px} +.grid{display:grid;grid-template-columns:1fr;gap:14px} +@media(min-width:720px){.grid{grid-template-columns:1fr 1fr}} +h2{margin:0 0 8px} +h3{margin:0 0 8px} +ol,ul{margin:8px 0 0 20px;color:var(--muted)} +code{background:var(--glass);padding:2px 6px;border-radius:6px;color:var(--accent)} +.muted{opacity:0.95;font-size:0.95rem} +footer.card{background:transparent;border:0;padding-top:6px} +button{font:inherit} + +/* small utilities */ +.subtitle button{font-weight:600} + +/* link styles */ +a{color:var(--accent)} + +/* responsive tweaks */ +@media(max-width:520px){header h1{font-size:1.2rem}.container{padding:0 14px}} + +figure{margin:12px 0 0;border-radius:8px;overflow:hidden} +figure img{width:100%;height:auto;display:block;border:1px solid rgba(255,255,255,0.04)} +figcaption{font-size:0.9rem;color:var(--muted);margin-top:8px} + +.grid-two{display:grid;grid-template-columns:1fr 1fr;gap:14px} + +