Welcome to TMA Cloud

Self-hosted cloud storage with a web app, a desktop app and Cloud Drive, storing files encrypted in your own S3-compatible bucket.

FeaturesCopy Anchor Link

• Encrypted Storage --- Encrypt files with AES-256-GCM in any S3-compatible bucket
• Cloud Drive --- Open and save cloud files from any app on Windows, Linux or macOS
• 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 StartCopy Anchor Link

Get TMA Cloud running with one command. It needs Docker with Compose v2.

curl -fsSL https://raw.githubusercontent.com/TMA-Cloud/TMA/main/setup.sh | bash

The script creates ./tma-cloud, fills every password and key with random values, and starts the stack. See Docker Deployment for what it does, how to read it before running it, and its options.

Once the containers are healthy, open http://localhost:3000 and create the first account — that account becomes the admin. Then connect a bucket in Settings → Storage (Storage Bucket); files cannot be uploaded until one is saved.

Back up the encryption key; stored files cannot be decrypted without it. See Backups.

Where to go nextCopy Anchor Link

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 StructureCopy Anchor Link

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

Ready to get started? Head to Getting Started →