Session Storage (Beta)

RStudio Workbench needs to be able to find information about active sessions in order to correctly display that information to the user. By default this information is saved on the file system under the user’s home directory. RStudio Workbench can be configured to store the information in the internal database by adding the following configuration option:

# /etc/rstudio/rserver.conf

This feature is in beta. Beta features are supported and unlikely to face breaking changes in a future release. Any issues found in the feature will be addressed during the regular release schedule; they will not result in immediate patches or hotfixes. We encourage customers to try these features and we welcome any feedback, but we recommend that the feature not be used in production until it is in general availability (i.e., officially released as a full feature).

In order to ensure that no unexpected behavior occurs, we recommend that the following procedure is followed: 1. All users fully quit their sessions. 2. Stop RStudio Workbench using sudo rstudio-server stop. 3. Add session-use-file-storage=0 to /etc/rstudio/rserver.conf. 4. Start RStudio Workbench using sudo rstudio-server start.

Networking Considerations

Some of the information that is saved is written by the R Session process. The R Session processes do not have direct access to the database, so they will send the information to the RStudio Workbench server process over a network call. For sessions started through the Launcher the launcher-sessions-callback-address must be correctly configured. For more information on configuring the launcher-sessions-callback-address see the Server Options section of the Launcher Configuration chapter.