Documentation

Everything you need to get started with tinymount.

Installation

Install the tinymount CLI with a single command:

curl -sSL https://tinymount.com/install.sh | sh

This installs the tinymount binary to /usr/local/bin.

Requirements

Linux or macOS (Intel or Apple Silicon)
FUSE support: apt install fuse3 on Linux, macFUSE on macOS

Manual Installation

You can also download binaries directly from GitHub Releases.

Quick Start

Get up and running in under a minute.

1. Create an account

tinymount register

2. Create a volume

tinymount create my-data
# You'll be prompted for an encryption password

3. Mount it

tinymount mount my-data ~/cloud
# Enter your encryption password

4. Use it like any folder

cp -r ~/projects ~/cloud/
ls ~/cloud/

Tip

Your encryption password never leaves your device. If you forget it, your data cannot be recovered.

Authentication

Manage your tinymount session.

Register a new account

tinymount register

Log in to existing account

tinymount login

Check current session

tinymount whoami

Log out

tinymount logout

Volumes

Volumes are encrypted storage containers that you can mount as folders.

Create a volume

tinymount create my-volume

Optionally specify a region: --region weur

List your volumes

tinymount list

Get volume details

tinymount info my-volume

Delete a volume

tinymount destroy my-volume

This permanently deletes all data in the volume. This action cannot be undone.

Mounting

Mount volumes to access them as local folders.

Mount a volume

tinymount mount my-volume ~/cloud

Unmount

tinymount unmount ~/cloud

Check active mounts

tinymount status

Important

Always unmount before shutting down to ensure all data is synced.

Encryption

All volumes are encrypted by default using AES-256-GCM.

What's encrypted

File contents are encrypted client-side before upload
Your password derives the encryption key locally (Argon2id)
The password never leaves your device
We store only ciphertext — we cannot read your file contents

What's visible to us

File and folder names (metadata)
Directory structure
File sizes and timestamps

Full zero-knowledge mode with encrypted filenames is on our roadmap.

Lost Password

If you forget your encryption password, your data is permanently unrecoverable. We cannot reset it.

Regions

Choose a region close to you for the best performance.

Code	Location
`wnam`	Hillsboro, Oregon (US West)
`weur`	Nuremberg, Germany (Europe)

More regions coming soon.

tinymount create my-data --region weur

Test latency

Find the best region for your location:

tinymount regions --test-latency

CLI Commands

Command	Description
register	Create a new account
login	Log in to your account
logout	Log out of your account
whoami	Show current user info
create <name>	Create a new volume
list	List all volumes
info <name>	Show volume details
destroy <name>	Delete a volume
mount <name> <path>	Mount a volume
unmount <path>	Unmount a volume
status	Show active mounts
regions	List available regions
usage	Show storage usage
version	Show version info

Configuration

tinymount stores configuration in ~/.tinymount/

Configuration file

~/.tinymount/config.json contains your API credentials and preferences.

Development mode

Use the --dev flag to connect to a local API:

tinymount --dev login

FAQ

How do I mount on a second device?

Install the CLI, run tinymount login, then mount using the same encryption password. Changes sync in real-time between devices.

What happens if I forget my password?

Your data is permanently unrecoverable. We do not have access to your encryption keys.

Is my data stored in the cloud?

Yes, encrypted file contents are stored in Cloudflare R2. Only you can decrypt them.

What's the maximum file size?

There's no practical limit. JuiceFS handles large files efficiently through chunking.

Support

Need help? We're here for you.

GitHub Issues

github.com/tinyworks/tinymount/issues — bug reports and feature requests

Email

support@tinymount.com — direct support