Skip to content
CloudZH

Docs / Using CloudZH

Terminal & Files

A real shell and a full file manager in the browser, with stricter rules than the rest of the dashboard.

Terminal

  • A shell as the Linux user who installed CloudZH. sudo asks for that user's Linux password.
  • Only administrators with a passkey or 2FA. Every new session asks for your password.
  • By default only from your home network or VPN.
  • Several sessions as tabs. They keep running when you change page and close 30 minutes after the last window.
zh terminal status
zh terminal off
zh terminal remote on    # also allow outside home and VPN
zh terminal close-all

Files

PlaceContainsAccess
Data/srv/dataRead and write
App dataFolders that belong to the app, never its compose fileRead and write
HomeHome of the Linux userSame rules as the terminal
System/Read only

Upload in pieces (also folders, drag and drop), download single files or as ZIP, copy, move, rename, pack and unpack, edit text, change permissions. Deleted files go to a 30-day recycle bin. Repair permissions helps when Sonarr or Radarr report "Permission denied". Turn the file manager off with zh files off.

External drives

Files has three tabs: Internal, External (mounted USB disks) and Drives. A disk you plug in appears under Drives with its file system, size and model.

  • Mount, Unmount and Safely remove (writes everything, unmounts and powers the disk down).
  • Mount automatically when plugged in and after a restart (on by default), read only and a display name per disk.
  • Format a new disk as ext4 (best for this server) or exFAT (also readable on Windows and Mac). Asks for your password and the disk name; disks with data, app data or the system are never offered.
  • Copy or move between your data and an external disk with cut, copy and paste across tabs.

Supported: exFAT, FAT32, NTFS, ext4, ext3, ext2, XFS and Btrfs. Disks are mounted under /mnt/cloudzh/<name> without the right to run programs.

zh disk                     # list with numbers
zh disk mount 1
zh disk eject 1