On this page

How-to

Check free space and what is using it

The Storage page shows how full each of your folders or disks is, and can sort the space by type, such as TV, films and books. Use it to find out how much room is left before a disk fills up.

Before you begin

Starboard can only read the folders you gave it. It reads them but never changes them. Give them in one of these ways:

  • With the installer: run ./install.sh again and answer Yes to Choose folders to show? Enter each folder as a name and a path, such as Media=/mnt/media, one per line. An empty line finishes. Read Change what Starboard can access.
  • With the ready-made image: take the # off the Storage lines in compose.image.yaml. Read Change what Starboard can access.

Steps

  1. Go to System, then Storage.
  2. Read the tiles: Total space, how much is Used, and how many folders are over 90% full.
  3. Find each folder in the list, fullest first. Each one says Healthy, Nearly full or Not found.
  4. Select a folder to read its path, its file system, and how much is used and free.

Sort the space by type

  1. On the Storage page, find What is using the space.
  2. Select Sort by type now. The button says Sorting by type… while Starboard reads the folders.
  3. Wait. A large disk can take a few minutes. The charts then show the space by type, with free space.

To sort again later, select Sort by type again.

Things to note

  • Sorting by type reads every file name in your folders, so it runs only when you choose. To run it on a schedule, change Work out what uses the space in Settings, Performance, under More settings. Read Make Starboard use less of your server.
  • Space used over time needs Daily record of used space active in the same place. It shows a forecast of when the space runs out, after a week of readings.
  • Disks in the pool lists each disk in the pool, fullest first. Read What a disk pool is.
  • Disks in this computer lists every disk and where it is used. It needs Disk health set up. Read Check your disks' health.
  • A file shared by a download and the library counts once, for the library.
  • A disk with a Windows file system, such as NTFS, is marked as slower on Linux.

If it does not work

  • No folders set up yet: Starboard has no folders to show. Give it some as in Before you begin.
  • Starboard cannot find this folder: the folder is missing, or not shared with Starboard. Check the path, then run ./install.sh again or check compose.image.yaml.
  • Sorting by type is inactive: Work out what uses the space is set to Off in Settings, Performance, under More settings.
  • Nearly full: free some space or add a disk before it fills. Downloads stop when there is no room. To be told before this happens, read Activate alerts.

Find out more

This page on GitHub, where the help is written.