🔐 BUNKER

Lightning-fast, secure password management that just works.

---

⚡ Why Bunker?

Bunker is the password manager that gets out of your way. Built in Rust for blazing performance and iron-clad security, it's designed for developers who value speed, simplicity, and reliability.

🚀 Setup in 30 seconds

# Install and initialize in one go
cargo install bunker
bunker init my-vault
bunker add github
# Done! Your first password is stored and encrypted.

🔒 Enterprise-grade security

• Argon2 key derivation with vault-specific salts
• ChaCha20-Poly1305 authenticated encryption
• Zero-knowledge architecture - your data never leaves your device
• Git integration for version control and backup

⚡ Lightning fast

• Rust-powered performance
• No cloud dependencies - everything runs locally
• Instant search across all your data
• Smart caching - unlock once, use all day

---

🚀 Quick Start

Prerequisites

• Rust 1.70+ (install here)
• Git (for version control)

Local Development

# Clone and build
git clone https://github.com/simplysabir/bunker.git
cd bunker
cargo build --release

# Initialize your first vault
./target/release/bunker init my-vault

# Add your first password
./target/release/bunker add github

# List all passwords
./target/release/bunker list

# Copy password to clipboard
./target/release/bunker copy github

Docker (Recommended for Production)

# Build and run with Docker Compose
docker-compose up --build

# Or build manually
docker build -t bunker .
docker run -it --rm -v $(pwd)/vaults:/app/vaults bunker init my-vault

---

🎯 Core Features

Feature	Description	Speed
🔐 Password Storage	Encrypted passwords with metadata	Instant
🔍 Smart Search	Search across all fields (hidden from UI)	<100ms
📋 Clipboard Integration	Auto-clear with configurable timeout	<50ms
🏷️ Rich Metadata	Usernames, notes, URLs, tags, custom fields	Instant
🔄 Git Sync	Version control and backup	<1s
📤 Import/Export	Vault portability across devices	<2s
🔒 Session Management	Unlock once, use all day	<100ms

---

🛠️ Commands

Essential Commands

bunker init <vault>          # Create new vault
bunker add <key>             # Add password
bunker get <key>             # View password
bunker copy <key>            # Copy to clipboard
bunker list                  # List all entries
bunker search <query>        # Search entries
bunker edit <key>            # Edit entry
bunker delete <key>          # Remove entry

Advanced Commands

bunker vault use <name>      # Switch vaults
bunker vault export          # Export vault
bunker vault import <file>   # Import vault
bunker git status            # Git status
bunker git commit            # Commit changes
bunker git push              # Push to remote
bunker backup                # Create backup
bunker restore <backup>      # Restore from backup

---

🐳 Docker Support

Dockerfile

FROM rust:1.75-alpine as builder
WORKDIR /app
COPY . .
RUN cargo build --release

FROM alpine:latest
RUN apk add --no-cache git
COPY --from=builder /app/target/release/bunker /usr/local/bin/
WORKDIR /app
VOLUME ["/app/vaults"]
ENTRYPOINT ["bunker"]

Docker Compose

version: '3.8'
services:
  bunker:
    build: .
    volumes:
      - ./vaults:/app/vaults
      - ~/.ssh:/root/.ssh:ro  # For Git operations
    environment:
      - RUST_LOG=info
    working_dir: /app
    command: ["init", "my-vault"]

.dockerignore

target/
.git/
.gitignore
README.md
Dockerfile
docker-compose.yml

---

🔧 Configuration

Vault Structure

~/.bunker/
├── config.toml          # Global configuration
├── vaults/
│   ├── my-vault/
│   │   ├── config.toml  # Vault-specific config
│   │   ├── entries/     # Encrypted password files
│   │   ├── .git/        # Git repository
│   │   └── sessions/    # Session data
│   └── work-vault/
└── sessions/            # Global sessions

Environment Variables

BUNKER_VAULT_NAME=my-vault    # Default vault
BUNKER_SESSION_TIMEOUT=86400  # Session timeout (seconds)
BUNKER_CLIPBOARD_TIMEOUT=45   # Clipboard clear timeout

---

🔒 Security Features

• Zero-knowledge encryption - Your master password never leaves your device
• Vault-specific salts - Each vault has unique cryptographic parameters
• Authenticated encryption - ChaCha20-Poly1305 prevents tampering
• Secure memory handling - Zeroize sensitive data after use
• Git integration - Version control and audit trail
• Session isolation - Vaults are completely isolated

---

🤝 Contributing

We love contributions! Here's how to get started:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Development Setup

git clone https://github.com/simplysabir/bunker.git
cd bunker
cargo build
cargo test
cargo fmt

---

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

Ready to secure your digital life? 🚀

cargo install bunker
bunker init my-vault

Questions? Open an issue or join our discussions!