Skip to content

Storage Classes

Storage Classes#

All storage locations default to subdirectories of the Server.DataDir setting. The available classes of variable data are listed below:

  • Cache - Stores data to increase performance for computationally intensive operations. Certain operations, such as Git package building, also temporarily cache data here. Defaults to <DataDir>/cache.
  • Launcher - Stores data for Job Launcher operations. This location currently stores the stdout and stderr data associated with each Git package builder operation. Defaults to <DataDir>/launcher. For highly available installations ensure that this directory is unique to each server. Consider using the Server.LauncherDir configuration option to customize this.
  • Metrics - This directory contains aggregated metrics data to improve Usage Stats performance. Defaults to <DataDir>/metrics.
  • Packages - Package tarballs and README files are stored here. Defaults to <DataDir>/packages. This includes:
    • Package tarballs and README files for local packages.
    • Package tarballs and README files git packages.
  • CRAN - Package tarballs and README files for CRAN are stored here. Defaults to <DataDir>/cran. This includes:
    • Package tarballs for CRAN packages that have been downloaded.
    • README files for CRAN packages.
  • PyPI - Package wheel and source files for PyPI packages are stored here. Defaults to <DataDir>/pypi. This includes:
    • Package wheels and source files for PyPI packages that have been downloaded.
  • Bioconductor - Package tarballs and README files for Bioconductor are stored here. Defaults to <DataDir>/bioconductor. This includes:
    • Package tarballs for Bioconductor packages that have been downloaded.
    • README files for Bioconductor packages.
  • Binaries - Pre-compiled R package binaries for CRAN packages are stored here. Defaults to <DataDir>/binaries.

While it is not recommended, you can customize the storage directory for each storage class. For example:

; /etc/rstudio-pm/rstudio-pm.gcfg

[FileStorage "cache"]
Location = /mnt/rstudio-pm-cache

[FileStorage "launcher"]
Location = /mnt/rstudio-pm-launcher

[FileStorage "metrics"]
Location = /mnt/rstudio-pm-metrics

[FileStorage "packages"]
Location = /mnt/rstudio-pm-packages

[FileStorage "cran"]
Location = /mnt/rstudio-pm-cran

[FileStorage "bioconductor"]
Location = /mnt/rstudio-pm-bioconductor

[FileStorage "pypi"]
Location = /mnt/rstudio-pm-pypi

[FileStorage "binaries"]
Location = /mnt/rstudio-pm-binaries

If you customize any of the RStudio Package Manager storage directories, the rstudio-pm user must have permission to read, write, and create directories in each data directory.