A secure, lightweight Progressive Web App for managing passwords and sensitive information with ease!
Features • Screenshots • Installation • Usage • Security • Development • Data Persistence • Roadmap • Contributing • License
- 🔒 Secure Information Storage: Safely store passwords, notes, and other sensitive data with AES-256-GCM encryption
- 📋 Universal Secure Clipboard: Use Vaulty as a secure clipboard for any type of sensitive information
- 🔢 User Authentication: Secure app access with username and password
- 🎲 Password Generator: Create strong, unique passwords with our built-in generator
- 📱 Cross-Device Syncing: Access your secure information across all your devices
- 🚀 Progressive Web App: Install and use offline on any device
- ⚡ Fast and Responsive: Built with Next.js for optimal performance
- 💾 Lightweight Database: Uses SQLite for simple, file-based data storage
- 🌓 Theme Toggle: Switch between Kali and Synthwave themes
- 🐳 Docker Support: Easy deployment with Docker
- Node.js (v14 or later)
- npm (v6 or later)
- Docker (optional, for containerized deployment)
-
Clone the repository:
git clone https://github.com/shooter-git/vaulty.git cd vaulty -
Copy the
.env.examplefile to.env.local:cp .env.example .env.local
-
Open
.env.localin a text editor and update the values:- Generate a secure
ENCRYPTION_KEY(64-character hex string):node -e "console.log(require('crypto').randomBytes(32).toString('hex'))" - Generate a secure
JWT_SECRET:node -e "console.log(require('crypto').randomBytes(64).toString('base64'))" - Generate a
NEXT_PUBLIC_ENCRYPTION_KEY(32-byte encryption key):node -e "console.log(require('crypto').randomBytes(32).toString('base64'))" - Set these values in your
.env.localfile, along with any other required environment variables.
- Generate a secure
-
Ensure Docker and Docker Compose are installed on your system.
-
Create a named volume for persistent data storage:
docker volume create vaulty-data
-
Build and start the Docker container:
docker compose up -d
-
The application will be available at
http://localhost:3010
-
Ensure Docker is installed on your system.
-
Create a named volume for persistent data storage:
docker volume create vaulty-data
-
Build the Docker image:
docker build -t vaulty . -
Run the Docker container:
docker run -d -p 3010:3010 \ --env-file .env.local \ -v vaulty-data:/app/data \ -v $(pwd)/.env.local:/app/.env.local:ro \ --name vaulty \ vaulty -
The application will be available at
http://localhost:3010
-
Install dependencies:
npm install
-
Initialize and update the database:
npm run db:init npm run db:update
-
Build the application:
npm run build
-
Start the server:
npm run start:with-db
-
Open your browser and navigate to
http://localhost:3010
- Sign Up/Login: Create a new account or log in to an existing one.
- Add New Entry: Click the "Add Password" button to add a new password or any sensitive information.
- Generate a Password: Use the built-in generator for strong, unique passwords when needed.
- Copy Information: Click on an entry to securely copy the stored information to your clipboard.
- Edit/Delete Entries: Manage your stored information with easy edit and delete functions.
- Use as Secure Clipboard:
- For temporary storage: Add sensitive information as a new entry.
- To retrieve: Copy the information to your clipboard and use it where needed.
- For security: The clipboard is automatically cleared after 10 seconds.
- Theme Toggle: Switch between Kali and Synthwave themes using the toggle in the navbar.
- All sensitive information (not just passwords) is encrypted using AES-256-GCM before storage
- The database file is stored locally and not synced to any cloud service by default
- HTTPS is used for all data transmissions when deployed
- Clipboard contents are automatically cleared after 10 seconds
- JWT is used for session management
- Information is never stored in plain text
- End-to-end encryption is implemented for all sensitive data
- Biometric access is available on supported devices (e.g., Face ID on iOS)
To run the application in development mode:
npm run devThis will start the development server with hot-reloading enabled.
The application uses a Docker named volume vaulty-data to store the SQLite database. This ensures that your data persists even if the Docker container is stopped or removed.
To backup the database:
-
Stop the running container:
docker compose down -
Create a backup of the volume:
docker run --rm -v vaulty-data:/dbdata -v $(pwd):/backup alpine tar cvf /backup/vaulty-backup.tar /dbdataThis will create a backup file named
vaulty-backup.tarin your current directory.
To restore from a backup:
-
Ensure the container is not running:
docker compose down -
Restore the backup:
docker run --rm -v vaulty-data:/dbdata -v $(pwd):/backup alpine sh -c "rm -rf /dbdata/* /dbdata/..?* /dbdata/.[!.]* ; tar xvf /backup/vaulty-backup.tar" -
Start the container:
docker compose up -d
Always ensure you have recent backups of your data, especially before performing updates or maintenance on the application.
We're constantly working to improve Vaulty and expand its capabilities. Here are some features and improvements we're planning for future releases:
-
App and Webpage Integration:
- Develop browser extensions for seamless integration with web applications.
-
User Account Management:
- Implement a secure password reset functionality.
- Add the ability for users to update their account information.
-
Advanced Security Features:
- Add support for two-factor authentication (2FA).
- Implement a secure password sharing feature.
-
Authentication Upgrade:
- Integrate Clerk for robust authentication and account creation functionality.
We're excited about these upcoming features and improvements. Stay tuned for updates, and feel free to contribute ideas or code to help make Vaulty even better!
We welcome contributions! Please see our Contributing Guide for more details.
This project is licensed under the MIT License - see the LICENSE file for details.




