Quick Start

Get FyVault running in 5 minutes. Install the SDK, connect a provider, or use FyVault.auto() for zero-config setup.

Install the SDK

Node.js

Terminalbash

npm install @fyvault/sdk

Python

Terminalbash

pip install fyvault

app.tstypescript

import { FyVault } from "@fyvault/sdk";
const fv = FyVault.auto();
const db = await fv.secrets.getValueByName("DATABASE_URL");

app.pypython

from fyvault import FyVault
fv = FyVault.auto()
db = fv.secrets.get_value_by_name("DATABASE_URL")

Or connect third-party providers directly — see Provider Connect.

Create an Account

Create Your Organization

After login, you'll be prompted to create an organization. This is your workspace for secrets, devices, and team members.

Set Up Vault Encryption

Go to Settings → Vault Encryption → Set up a vault passphrase.

Warning: This passphrase encrypts your secrets in the browser. If you lose it, your secrets cannot be recovered. There is no reset mechanism.

Create Your First Secret

Go to Secrets → Create Secret.

Example: OpenAI API Key

Type	API Key
Name	`OPENAI_API_KEY`
Value	`sk-proj-your-actual-key`
Target Host	`api.openai.com`
Header	`Authorization`
Template	`Bearer {{value}}`

Register a Device

Go to Devices → Register Device.

Get your device fingerprint:

Terminalbash

sudo cat /sys/class/dmi/id/product_uuid

Assign Secrets to the Device

Open the device detail page → Assigned Secrets → Assign Secret → Select OPENAI_API_KEY.

Install the Agent

On your server:

Terminalbash

curl -fsSL https://get.fyvault.com | bash -s -- \
  --token YOUR_DEVICE_TOKEN \
  --cloud https://api.fyvault.com/api/v1

Update Your .env

Before

.envenv

OPENAI_API_KEY=sk-proj-your-actual-key

After

.envenv

OPENAI_API_KEY=FYVAULT::openai_api_key

Start Your App

Your app runs exactly as before. The FyVault agent handles everything transparently — intercepting outbound connections and injecting real credentials at runtime.