rclone Mount

rclone mount exposes a remote as a local directory using FUSE (Filesystem in Userspace). Once mounted, you can use standard tools like ls, cp, cat, and any application to interact with remote files as if they were local.

Quick Summary

mount turns any rclone remote into a local filesystem mount point. It runs as a foreground process by default — use --daemon to run in the background. Requires FUSE to be installed on the system.

Basic Syntax

rclone mount REMOTE:PATH /local/mount/point [flags]

# Mount Google Drive to a local directory
rclone mount gdrive: /mnt/gdrive

# Mount a specific bucket/folder
rclone mount remote:my-bucket/data /mnt/data

# Mount in background (daemon mode)
rclone mount remote:my-bucket /mnt/remote --daemon

Prerequisites

Install FUSE

# Debian/Ubuntu
sudo apt install fuse3

# RHEL/CentOS/Fedora
sudo dnf install fuse3

# Verify
fusermount3 --version

Create Mount Point

sudo mkdir -p /mnt/remote
sudo chown $(whoami) /mnt/remote

Key Flags

Flag	Description
--daemon	Run in background
--allow-other	Allow other users to access the mount
--allow-root	Allow root to access the mount
--read-only	Mount as read-only
--vfs-cache-mode MODE	Caching: off, minimal, writes, full
--vfs-cache-max-size SIZE	Maximum cache size (e.g., 10G)
--vfs-cache-max-age DURATION	Maximum cache age (e.g., 1h)
--vfs-read-chunk-size SIZE	Read chunk size for streaming (e.g., 128M)
--dir-cache-time DURATION	Cache directory listings (e.g., 5m)
--poll-interval DURATION	Poll for remote changes (e.g., 1m)
--log-file PATH	Write log to file

VFS Cache Modes

Mode	Behavior	Best For
off	No caching — every read goes to remote	Minimal local disk usage
minimal	Small reads cached	Read-only browse
writes	Write locally first, upload later	Mixed read/write
full	Full file caching	Applications requiring random access

tip

For most use cases, --vfs-cache-mode writes provides the best balance between performance and reliability. Use full if applications need to seek within files (e.g., media players, databases).

Practical Examples

Mount Google Drive for Daily Use

rclone mount gdrive: /mnt/gdrive \
  --vfs-cache-mode writes \
  --vfs-cache-max-size 5G \
  --daemon

Mount S3 Bucket as Read-Only

rclone mount backup-s3:my-bucket /mnt/s3-backup \
  --read-only \
  --vfs-cache-mode minimal \
  --daemon

Mount with Full Caching for Applications

rclone mount remote:media /mnt/media \
  --vfs-cache-mode full \
  --vfs-cache-max-size 50G \
  --vfs-cache-max-age 24h \
  --allow-other \
  --daemon

Systemd Service for Auto-Mount

/etc/systemd/system/rclone-mount.service

[Unit]
Description=Rclone Mount
After=network-online.target
Wants=network-online.target

[Service]
Type=notify
ExecStart=/usr/bin/rclone mount remote:my-bucket /mnt/remote \
  --vfs-cache-mode writes \
  --vfs-cache-max-size 10G \
  --allow-other \
  --log-file /var/log/rclone/mount.log \
  --log-level INFO
ExecStop=/bin/fusermount -uz /mnt/remote
Restart=on-failure
RestartSec=10
User=rclone

[Install]
WantedBy=multi-user.target

sudo systemctl enable --now rclone-mount.service

Unmounting

# Graceful unmount
fusermount -u /mnt/remote

# Force unmount (lazy)
fusermount -uz /mnt/remote

Common Pitfalls

Pitfall	Consequence	Prevention
FUSE not installed	Mount fails silently	Install fuse3 package first
--vfs-cache-mode off with write-heavy apps	Write failures and data loss	Use writes or full cache mode
No --allow-other	Other users/services can't access mount	Add flag if multiple users need access
Forgetting to unmount before shutdown	Stale mount point	Use systemd service for managed lifecycle
Cache fills disk	Local disk runs out of space	Set --vfs-cache-max-size limit

What's Next

Examples with Output

1. Mount Google Drive as a local folder

Access your entire Drive contents through /mnt/gdrive. Command:

rclone mount gdrive: /mnt/gdrive --daemon

Output:

(Command returns immediately, drive is mounted in the background)

2. High-performance mount for media

Optimize settings for streaming video with a large buffer. Command:

rclone mount remote:movies /media/movies --vfs-cache-mode full --vfs-read-chunk-size 128M --daemon

Output:

(Files appear in /media/movies, seeking in video files will be smooth)

3. Read-only mount for shared assets

Safely expose a bucket so users can't accidentally delete files. Command:

rclone mount remote:assets /mnt/assets --read-only

Output:

(Mount point ready; any attempt to write will result in 'Read-only file system')

4. Background mount with logging

Monitor for errors or connection drops in a dedicated file. Command:

rclone mount gdrive: /mnt/drive --daemon --log-file rclone-mount.log --log-level INFO

Output:

(Logs written to rclone-mount.log)

5. Check mount health

Verify that remote files are visible locally. Command:

ls /mnt/gdrive | head -n 5

Output:

Backups
Documents
Photos
report.pdf
work_project

Note: This confirms the FUSE mount is active and fetching data.