Welcome to TMA Cloud

A self-hosted cloud storage platform with file storage and management capabilities.

Features

• Encrypted Storage --- Encrypt files with AES-256-GCM in any S3-compatible bucket
• Windows Cloud Drive --- Open and save cloud files from any Windows app
• Document Editing --- Edit with OnlyOffice or desktop apps and sync changes back
• Controlled Sharing --- Create read-only links with expiry and a separate domain
• Sub-user Access --- Give each login separate permissions over the same files
• Large-file Workflows --- Stream transfers and queue bulk file operations

Quick Start

Get TMA Cloud running locally in three commands.

1. Grab the compose file and example env:

curl -sSL -o docker-compose.yml https://raw.githubusercontent.com/TMA-Cloud/TMA/main/docker-compose.yml
curl -sSL -o .env https://raw.githubusercontent.com/TMA-Cloud/TMA/main/.env.example

2. (Optional) Edit .env to set a strong JWT_SECRET, FILE_ENCRYPTION_KEY, and database password before first boot. See Environment Variables for the full list.

3. Start the stack:

docker compose up -d

Once the containers are healthy, open http://localhost:3000 and create the first account — that account becomes the admin.

Where to go next

1. UI Gallery — Screenshots of the TMA Cloud interface
2. Getting Started — Installation and setup
3. Docker Deployment — Docker Compose (curl, no clone) or prebuilt
4. Concepts — System architecture
5. User Guides — How to use TMA Cloud day-to-day
6. API Reference — REST API
7. API Examples — Copy-paste request samples
8. Glossary — Terms used throughout the docs

Documentation Structure

• Getting Started --- Installation, setup, and first steps
• Concepts --- Core concepts and architecture
• Guides --- Step-by-step instructions for users and admins
• API --- Complete API reference
• Debugging --- Troubleshooting common issues
• Reference --- Environment variables, schemas, and technical details
• Changelog --- Version history and updates

Ready to get started? Head to Getting Started →