> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vanna.finance/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Your Wallet

> Step-by-step guide to connecting your Stellar wallet to Vanna and claiming testnet tokens from the faucet.

<div className="vanna-poster">
  <div className="vanna-poster-orb-violet" />

  <div className="vanna-poster-orb-rose" />

  <div className="vanna-poster-grid" />

  <div className="vanna-poster-grain" />

  <div className="vanna-poster-content">
    <img src="https://mintcdn.com/vannafinance/UHj8oBBMt2jwIvZH/logo/vanna-dark.png?fit=max&auto=format&n=UHj8oBBMt2jwIvZH&q=85&s=8d4a259c94861810159a811d7d5a66bd" className="vanna-poster-logo" alt="Vanna" width="307" height="96" data-path="logo/vanna-dark.png" />

    <div className="vanna-ob-board">
      <div className="vanna-ob-sub">Four simple steps to start exploring Vanna</div>

      <div className="vanna-ob-steps">
        <div className="vanna-ob-step">
          <div className="vanna-ob-icon-wrap">
            <div className="vanna-ob-icon">
              <svg width="30" height="30" viewBox="0 0 24 24" fill="none" stroke="rgba(155,143,255,0.9)" strokeWidth="1.5" strokeLinecap="round" strokeLinejoin="round">
                <rect x="2" y="6" width="20" height="14" rx="2" />

                <path d="M2 10h20" />

                <circle cx="17" cy="15" r="1.2" fill="rgba(155,143,255,0.9)" stroke="none" />
              </svg>
            </div>

            <div className="vanna-ob-badge">1</div>
          </div>

          <div className="vanna-ob-name">Install Wallet</div>
          <div className="vanna-ob-helper">Install a supported<br />Stellar wallet</div>
        </div>

        <div className="vanna-ob-conn">
          <div className="vanna-ob-line" />
        </div>

        <div className="vanna-ob-step">
          <div className="vanna-ob-icon-wrap">
            <div className="vanna-ob-icon">
              <svg width="30" height="30" viewBox="0 0 24 24" fill="none" stroke="rgba(155,143,255,0.9)" strokeWidth="1.5" strokeLinecap="round" strokeLinejoin="round">
                <path d="M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71" />

                <path d="M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71" />
              </svg>
            </div>

            <div className="vanna-ob-badge">2</div>
          </div>

          <div className="vanna-ob-name">Connect to Vanna</div>
          <div className="vanna-ob-helper">Connect your wallet<br />to the Vanna app</div>
        </div>

        <div className="vanna-ob-conn">
          <div className="vanna-ob-line" />
        </div>

        <div className="vanna-ob-step">
          <div className="vanna-ob-icon-wrap">
            <div className="vanna-ob-icon">
              <svg width="30" height="30" viewBox="0 0 24 24" fill="none" stroke="rgba(155,143,255,0.9)" strokeWidth="1.5" strokeLinecap="round" strokeLinejoin="round">
                <path d="M12 2.69l5.66 5.66a8 8 0 1 1-11.31 0z" />
              </svg>
            </div>

            <div className="vanna-ob-badge">3</div>
          </div>

          <div className="vanna-ob-name">Get Test Tokens</div>
          <div className="vanna-ob-helper">Claim testnet assets<br />from the faucet</div>
        </div>

        <div className="vanna-ob-conn">
          <div className="vanna-ob-line" />
        </div>

        <div className="vanna-ob-step">
          <div className="vanna-ob-icon-wrap">
            <div className="vanna-ob-icon vanna-ob-icon--done">
              <svg width="30" height="30" viewBox="0 0 24 24" fill="none" stroke="white" strokeWidth="3" strokeLinecap="round" strokeLinejoin="round">
                <path d="M20 6L9 17L4 12" />
              </svg>
            </div>

            <div className="vanna-ob-badge vanna-ob-badge--done">4</div>
          </div>

          <div className="vanna-ob-name">Start Exploring</div>
          <div className="vanna-ob-helper">Deposit, borrow, or<br />explore the protocol</div>
        </div>
      </div>
    </div>
  </div>
</div>

## Step 1 - Set Up a Stellar Wallet

Vanna supports any Stellar-compatible wallet. If you don't have one yet, here are a few popular options:

* **Freighter** - [freighter.app](https://freighter.app) (browser extension)
* **LOBSTR** - [lobstr.co](https://lobstr.co) (mobile + web)
* **xBull** - [xbull.app](https://xbull.app) (browser extension)

Once installed, create a new account or import an existing one using your secret key or recovery phrase.

<Warning>
  Keep your recovery phrase safe and offline. Vanna will never ask for it.
</Warning>

## Step 2 - Connect to Vanna

Navigate to the Vanna Product website. Click on **Launch App** on the homepage. Once the app launches, click **Connect Wallet** in the top-right corner.

Select your wallet from the connection modal and approve the request. Once approved, your Stellar address will appear in the top-right corner - you are now connected.

<div style={{ display: "flex", justifyContent: "center", margin: "24px 0" }}>
  <img src="https://mintcdn.com/vannafinance/UHj8oBBMt2jwIvZH/images/onboarding/afterConnectingWallet.png?fit=max&auto=format&n=UHj8oBBMt2jwIvZH&q=85&s=013ab8fa7a66e53cacda0988eadfcb64" alt="Wallet connected" style={{ maxWidth: "500px", width: "100%" }} width="452" height="434" data-path="images/onboarding/afterConnectingWallet.png" />
</div>

## Step 3 - Get Testnet Tokens (Testnet only)

If you want to try Vanna without using real funds, switch to testnet first:

1. Open your wallet and switch the network to **Testnet**. Return to the Vanna app - it detects the change automatically.

2. Click the **Faucet** button in the top navigation bar to open the faucet modal.

3. Click **Mint** next to the tokens you need, or click **Mint All** to claim all available test tokens at once. Each mint requires a wallet signature.

<div style={{ display: "flex", justifyContent: "center", margin: "24px 0" }}>
  <img src="https://mintcdn.com/vannafinance/UHj8oBBMt2jwIvZH/images/onboarding/TestnetFaucet.png?fit=max&auto=format&n=UHj8oBBMt2jwIvZH&q=85&s=2ff0baffca6f9dba1b68875cd4f3df24" alt="Testnet Faucet" style={{ maxWidth: "500px", width: "100%" }} width="574" height="519" data-path="images/onboarding/TestnetFaucet.png" />
</div>

<Warning>
  Always keep a small XLM balance in your wallet. Every Stellar transaction requires a small XLM network fee - if your XLM balance reaches zero, all transactions will fail.
</Warning>

## Now, choose your path

<CardGroup cols={2}>
  <Card title="For Liquidity Providers" href="/guides/earn/overview" icon="piggy-bank">
    Supply assets to Vanna's lending pools and earn yield from borrower interest - passively, with no positions to manage.
  </Card>

  <Card title="For Traders & Borrowers" href="/guides/margin/overview" icon="chart-candlestick">
    Open a Margin Account, deposit collateral, and borrow up to 10× leverage. Deploy your capital composably across DeFi markets.
  </Card>
</CardGroup>