Self-hosted cloud platform in a single binary - Share files, collaborate in real-time, and manage users with zero dependencies.

🚀 No installation required - Download and run on Windows or Linux

---

📥 Quick Start

⬇️ Download Latest Release

Windows

# Download the .exe, then:
folderhost.exe

Linux

# Download and extract
wget https://github.com/MertJSX/folderhost/releases/download/v25.11.1/folderhost-linux-amd64.zip
unzip folderhost-linux-amd64.zip
chmod +x folderhost

# Run
./folderhost

---

📊 Why FolderHost?

Feature	FolderHost	Nextcloud	FileRun
Single Binary	✅	❌	❌
Zero Dependencies	✅	❌	❌
Real-time Editing	✅	❌	❌
Easy Setup	✅	❌	❌

---

✨ Features

🚀 Core

• Single Binary Deployment - No dependencies, just run
• High Performance - Built with Go backend + React frontend
• Real-time Collaboration - Live code editing with Monaco Editor
• Multi-user Support - Permissions system

🔧 File Management

• Full file operations (upload, download, move, copy, rename)
• Chunked file uploads for large files
• Recovery bin with configurable limits
• Storage quota management per folder

🔒 Security & Monitoring

• JWT-based authentication
• Granular user permissions
• Audit logs for all activities
• Configurable storage limits

---

🖥️ Web Panel

Explorer

Collaborative Code Editor

---

⚙️ Configuration

On first run, a config.yml file will be created. Edit it to customize:

⚠️ Important: Change secret_jwt_key and admin password before starting to use!

Show config

#      _______   __   __
#     / _____/  / /  / /
#    / /__     / /__/ /
#   / ___/    / ___  /
#  / /       / /  / /
# /_/       /_/  /_/  By MertJSX
#
# Thanks for using my application!!! Please report if you catch any bugs!
# Here is the GitHub page of Folderhost: https://github.com/MertJSX/folderhost-go
#

# Port is required. Don't delete it!
port: 5000

# This is folder path. You can change it, but don't delete.
folder: "./host"

# Limit of the folder. Examples: 10 GB, 300 MB, 5.5 GB, 1 TB...
# You can remove it if you trust users.
storage_limit: "10 GB"

# This is secret json web token key to create tokens.
secret_jwt_key: "you must change it" # Example: 5asdasd1asd

# Admin account properties
admin:
username: "admin"
email: "example@email.com"
password: "123"
permissions:
  read_directories: true
  read_files: true
  create: true
  change: true
  delete: true
  move: true
  download: true
  upload: true
  rename: true
  extract: true
  copy: true
  read_recovery: true
  use_recovery: true
  read_users: true
  edit_users: true
  read_logs: true

# Holds deleted files. Accidentally, you might delete files that you don't want to delete.
recovery_bin: true

# Optionally you can limit recovery_bin storage. You can remove it if you want.
bin_storage_limit: "5 GB"

# Enable/Disable logging activities
log_activities: true

# Clears logs automatically after some days. If you want to disable it set the value to 0.
clear_logs_after: 7 # Days

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

---

📝 License

MIT License

---

🙏 Credits

Built with ❤️ by MertJSX

Tech Stack:

• Backend: Go
• Frontend: React + TypeScript + Vite
• Editor: Monaco Editor
• Database: SQLite