libPaths {base}R Documentation

Search Paths for Packages


.libPaths gets/sets the library trees within which packages are looked for.





new a character vector with the locations of R library trees. Tilde expansion (path.expand) is done, and if any element contains one of *?[, globbing is done where supported by the platform: see Sys.glob.


.Library is a character string giving the location of the default library, the ‘library’ subdirectory of R_HOME. is a (possibly empty) character vector giving the locations of the site libraries, by default the ‘site-library’ subdirectory of R_HOME (which may not exist).

.libPaths is used for getting or setting the library trees that R knows about (and hence uses when looking for packages). If called with argument new, the library search path is set to the existing directories in unique(c(new,, .Library)) and this is returned. If given no argument, a character vector with the currently active library trees is returned.

The library search path is initialized at startup from the environment variable R_LIBS (which should be a colon-separated list of directories at which R library trees are rooted) followed by those in environment variable R_LIBS_USER. Only directories which exist at the time will be included.

By default R_LIBS is unset, and R_LIBS_USER is set to directory ‘R/R.version$platform-library/x.y’ of the home directory, for R x.y.z. can be set via the environment variable R_LIBS_SITE (as a colon-separated list of library trees).

Function .libPaths always uses the values of .Library and in the base name space. can be set by the site in ‘’, which should be followed by a call to .libPaths(.libPaths()) to make use of the updated value.


A character vector of file paths.


Becker, R. A., Chambers, J. M. and Wilks, A. R. (1988) The New S Language. Wadsworth & Brooks/Cole.

See Also



.libPaths()                 # all library trees R knows about

[Package base version 2.5.0 Index]