Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Troubleshooting

“rclone not found”

ratclone runs rclone from your PATH. Install it (see Installation), or point ratclone at it with rclone_path in the configuration or --rclone PATH.

“rclone … is too old”

ratclone needs rclone v1.68.0 or newer, and Debian and Ubuntu ship 1.60. Install the current release from rclone.org:

sudo -v ; curl https://rclone.org/install.sh | sudo bash

If you have several rclones, rclone_path chooses which one ratclone runs.

“rclone rcd did not start” or “cannot reach rclone”

The background rclone failed to start or stopped answering. Its log is in ~/.local/state/ratclone/rcd.log; the last lines usually say why. A stale socket from a crash is cleaned up on the next start. If XDG_RUNTIME_DIR is not set (some su and container sessions), the socket goes to /tmp/ratclone-UID/ instead.

A copy or a listing fails

The error in the app is rclone’s own. Try the same thing with the rclone command shown for the transfer, and check rcd.log. Expired logins are a common cause: A in the accounts list signs in again.

Icons show as boxes or question marks

The icons need a Nerd Font in your terminal. Install one, or switch to ASCII icons: Icons in the settings (,), or icons = "ascii" in config.toml.

No colours, or wrong colours

ratclone draws in truecolor. Most terminals support it; inside tmux, add set -as terminal-features ",*:RGB" to ~/.tmux.conf. When the NO_COLOR environment variable is set, colours are turned off.

“Window too small”

The terminal is too small to draw the app: make it bigger. Below 80 columns the accounts list is hidden to leave room for the files.

The browser does not open for a login

Over SSH there is no browser, so ratclone shows an rclone authorize command to run on a machine that has one. If it guessed wrong, L switches between the two ways. See Browser logins.

Still stuck?

Ask in Discussions, or open an issue with your ratclone and rclone versions and the last lines of rcd.log.