Getting Started with Fortilis

Set up your secure vault in under 5 minutes. This guide covers everything from account creation to managing secrets for your team.

Jump to Section

1 Create Your Account

Fortilis uses your GDK Digital account for authentication. If you already use any GDK product (FTC, GDK-CRM), you can sign in with the same credentials.

New Users

  1. Go to gdkdigital.com/register.html
  2. Enter your name, email, and a strong password
  3. Verify your email address
  4. You're ready to sign in to Fortilis

Existing GDK Users

Download Fortilis from our download page, install it, and sign in with your existing email and password.

Tip: Your GDK account password is used only for platform authentication. Your vault has its own separate master password for encrypting your secrets.

2 Set Up Your Vault

After signing in for the first time, Fortilis will ask you to create a master password for your encrypted vault.

Creating Your Master Password

Your master password is the key to all your secrets. It encrypts your vault locally on your device using AES-256-GCM encryption with Argon2id key derivation.

Important: Fortilis uses zero-knowledge encryption. Your master password never leaves your device and is never stored on our servers. If you lose it, we cannot recover your vault. Consider writing it down and storing it in a physical safe.

How Encryption Works

When you set your master password:

  1. A Master Key is derived from your password using Argon2id (memory-hard, time-resistant)
  2. A random Data Key is generated and used to encrypt all your secrets (AES-256-GCM)
  3. The Data Key is wrapped (encrypted) with the Master Key and stored locally
  4. When you unlock your vault, the Master Key unwraps the Data Key to decrypt your secrets

This two-layer approach means changing your master password only re-wraps the Data Key - it doesn't re-encrypt every secret.

3 Organize with Projects

Projects are the primary way to organize your secrets. Create one project per application, service, or team.

Creating a Project

  1. Click the + button in the sidebar
  2. Enter a project name (e.g., "Production API", "AWS Staging", "Client Portal")
  3. Your project is created with a default environment file

Environment Files

Each project can have multiple environment files, similar to .env.development, .env.staging, and .env.production. Click the + tab above the secrets list to add new environment files.

Branch View

For Git-integrated workflows, switch to Branch view to organize secrets by Git branch. Fortilis can auto-detect your current branch and show the relevant secrets.

4 Store Your Secrets

Fortilis supports multiple secret types beyond simple key-value pairs.

Adding a Secret

  1. Select a project and environment file
  2. Click "Add Secret" or use the keyboard shortcut Ctrl+N
  3. Choose a secret type and fill in the details
  4. Click Save - your secret is encrypted immediately

Supported Secret Types

Environment Variables - Standard key-value pairs
JSON Config - Full JSON configuration files
Certificates - SSL/TLS certificates and keys
SSH Keys - Public and private key pairs
Database Credentials - Host, port, user, password
API Config - Endpoints, tokens, and auth details

Clipboard Security

When you copy a secret value, Fortilis automatically clears it from your clipboard after 45 seconds. This prevents accidentally pasting secrets into the wrong place.

Version History

Every time you update a secret, the previous value is preserved. You can view the full history of a secret and roll back to any previous version if needed.

5 Password Manager

Fortilis includes a full-featured password manager with breach monitoring and a password generator.

Storing Passwords

Navigate to Passwords in the sidebar. Each password entry stores:

Password Generator

Use the built-in generator to create strong, random passwords. Configure length, character types (uppercase, lowercase, numbers, symbols), and get a strength score before saving.

Breach Monitoring

Fortilis can check your passwords against the Have I Been Pwned (HIBP) database to identify compromised credentials. This check uses k-anonymity - only a partial hash of your password is sent, so the full password is never exposed.

6 Import Your Data

Switching from another password manager? Fortilis can import your data directly.

Supported Import Sources

How to Import

  1. Go to Import Data in the sidebar
  2. Select the source format
  3. Upload your exported file or paste the data
  4. Map fields if needed and confirm the import
  5. Your data is encrypted and stored in Fortilis

Tip: After importing, delete the exported file from your computer. Exported password files are unencrypted and should not be kept around.

7 Browser Extension

The Fortilis browser extension provides autofill for login forms and quick access to your passwords directly in the browser.

Installation

The extension is available for Chrome, Firefox, and Edge. Install it from your browser's extension store or load the unpacked extension for development.

Features

Autofill - Automatically fills login forms with saved credentials
Save New Logins - Prompts to save when you log in to a new site
Generate Passwords - Create strong passwords directly in forms
Phishing Protection - Warns when URLs don't match saved domains

How Autofill Works

  1. Navigate to a login page
  2. Click the Fortilis icon in your browser toolbar (or use Ctrl+Shift+F)
  3. Select the matching credential
  4. Username and password are filled automatically

Tip: The extension communicates with the Fortilis desktop app running on your computer. Make sure Fortilis is open and unlocked for autofill to work.

8 CLI Tool (Developers)

The fort CLI lets you inject secrets into processes and access your vault from the terminal.

Secret Injection

Run any command with your secrets automatically injected as environment variables:

# Inject secrets from a project into your app's environment
fort run --project "My API" --env production -- npm start

# Inject into a Python script
fort run --project "ML Pipeline" --env staging -- python train.py

# Inject into a Docker build
fort run --project "Backend" --env production -- docker compose up

Secrets are injected as environment variables into the child process only - they're never written to disk or shell history.

Other CLI Commands

# List projects
fort list projects

# List secrets in a project
fort list secrets --project "My API"

# Get a single secret value
fort get DB_PASSWORD --project "My API" --env production

# Start the MCP server for AI agent integration
fort mcp

Tip: The CLI communicates with the running Fortilis desktop app via a local TCP socket. Make sure Fortilis is open and your vault is unlocked before using CLI commands.

9 Team Sharing

Share secrets securely with your team using end-to-end encryption. Team members never see each other's master passwords.

How Team Sharing Works

  1. Invite a member - Send an invitation from the project settings
  2. Key exchange - When the invited user accepts, a secure RSA key exchange encrypts the project's data key with their public key
  3. Shared access - Team members can now decrypt project secrets using their own master password

Role-Based Access Control

Fortilis has four permission levels:

Audit Trail

Every action in a shared project is logged in an immutable audit trail with SHA-256 hash chain integrity. You can see who accessed which secret and when, detect any tampering, and export audit logs for compliance.

10 Security Overview

Fortilis is designed with security as a core principle, not an afterthought.

Encryption

Memory Safety

Clipboard Protection

Copied secrets are automatically cleared from your clipboard after 45 seconds. On supported operating systems, Fortilis also requests that clipboard history managers ignore the copied content.

Bring Your Own Database (BYOD)

For teams that need cloud sync, Fortilis supports "Bring Your Own Database" - connect your own PostgreSQL, MySQL, Google Sheets, AWS S3, or Cloudflare R2 backend. Your encrypted data syncs through infrastructure you control.

Ready to Get Started?

Set up your vault in under 5 minutes and start managing secrets securely.

Sign In to Vault Explore Fortilis