How to Change .libPaths() permanently in R?

Question

Whenever I change the library path order using the .libPaths() function, it reverts back to the default if I restart R. How can I change this permanently? I am working on a Linux computing cluster (I don't have admin rights) so, I want to add my local library to R permanently.

I have to do this every time I start R

.libPaths(c("/home/...","/home...","/local/library"))

Answer 1

For completeness, and as I can't show this in a comment:

1. Default on all Debian and Ubuntu systems with the shipped R package:

   edd@max:~$ R -q -e 'print(.libPaths())' R> print(.libPaths()) [1] "/usr/local/lib/R/site-library" "/usr/lib/R/site-library" [3] "/usr/lib/R/library"
   R> R>

2. Which we can alter by modifying R_LIBS_SITE:

   edd@max:~$ R_LIBS_SITE="/usr/lib/R/Library" R -q -e 'print(.libPaths())' R> print(.libPaths()) [1] "/usr/lib/R/library" R> R>

3. But modifying R_LIBS does not work:

   edd@max:~$ R_LIBS="/usr/lib/R/Library" R -q -e 'print(.libPaths())' R> print(.libPaths()) [1] "/usr/local/lib/R/site-library" "/usr/lib/R/site-library" [3] "/usr/lib/R/library"
   R> R> edd@max:~$

See help(Startup) for the full and detailed treatment. On Debian and Ubuntu we have been setting these three directories as the default for well over a decade. As it is set via R_LIBS_SITE here, this is the variable you need to alter here. In general, you need to override the variable holding the value and you may not know ex ante which one that is.

As for the original answer, on Debian and Ubuntu we use the file /etc/R/Renviron. As help(Startup) details, you can set any number of ways to alter this permanently for your startup -- and all these points hold for all different OSs:

1. Alter the system files such as Renviron or Renviron.site if you have the proper permissions
2. Else alter the per-user file ~/.Renviron
3. Alternatively, alter the environment variables R_LIBS or R_LIBS_USER or R_LIBS_SITE at the system level if you have the proper permissions
4. Else alter the variables R_LIBS or R_LIBS_USER or R_LIBS_SITE at the user level.
5. Lastly, call .libPaths(...new path to be added here...) in your R startup files as e.g. in .Rprofile.

Do see help(Startup) for a fuller-length discussion.