rsession.conf
The following is a list of available options that can be specified in the rsession.conf configuration file, which controls behavior of the rsession process, allowing you to tune various RStudio Pro Session parameters.
verify Settings
verify-installation
Verifies that the session installation is working correctly and exits.
Type: bool
Default: 0
version Settings
version
Prints the version number and exits.
Type: bool
Default: 0
docs Settings
docs-url
If specified, overrides the URL to navigate to when a user clicks on the RStudio help link.
Type: string
Default: <empty string>
session Settings
session-connections-block-suspend
Whether or not an active database connection should block attempts to suspend the session after timeout.
Type: bool
Default: 1
session-external-pointers-block-suspend
Whether or not R objects containing external pointers should block attempts to suspend the session after timeout.
Type: bool
Default: 1
session-timeout-minutes
The amount of minutes before a session times out, at which point the session will either suspend or exit.
Type: int
Default: 120
session-timeout-suspend
Indicates whether or not to suspend the session after the timeout has elapsed. Setting this to false will cause the session to quit instead of suspending to disk when the session times out.
Type: bool
Default: 1
session-disconnected-timeout-minutes
If set, causes the session to time out after not receiving any new connections within the specified minutes. This behavior is generally not needed, and you should instead use session-timeout-minutes
Type: int
Default: 0
session-preflight-script
Sets a script to be run on startup before any R initialization has occurred.
Type: string
Default: <empty string>
session-create-public-folder
Indicates whether or not to create a Public folder for the user whenever the session starts. This folder will have global read permissions, and can be used as a simple means for users to share files. It is recommended you do not use this feature, and instead use the more advanced Project Sharing features.
Type: bool
Default: 0
session-create-profile
Indicates whether or not to create a default empty .Rprofile script within the user’s home directory, which can be altered to perform any desired common startup tasks.
Type: bool
Default: 0
session-rprofile-on-resume-default
Specifies the default user setting for running the Rprofile when sessions are resumed.
Type: bool
Default: 0
session-save-action-default
Specifies the default save action (yes, no, or ask).
Type: string
Default: <empty string>
session-default-working-dir
Specifies the default working directory to use for new sessions.
Type: string
Default: <empty string>
session-default-new-project-dir
Specifies the default directory to use for new projects.
This option is deprecated and should not be used.
Type: string
Default: ~
show-help-home
Indicates whether or not to show the help home page on startup.
Type: bool
Default: 0
session-default-console-term
Specifies the default TERM setting for the R console.
Type: string
Default: xterm-256color
session-default-clicolor-force
Specifies the default CLICOLOR_FORCE setting for the R console.
Type: bool
Default: 1
session-quit-child-processes-on-exit
Indicates whether or not to quit child processes of the session on exit. If unset, child processes created by forking or parallel processing may continue to run in the background after the session is terminated.
Type: bool
Default: 0
session-first-project-template-path
Specifies the path to a first project template which will be copied into new users’ home directories and opened the first time they run a session. The template can optionally be configured with DefaultOpenDocs to cause documents to automatically be opened for the first project.
Type: string
Default: <empty string>
default-rsconnect-server
Specifies the default Posit Connect server URL.
Type: string
Default: <empty string>
websocket-ping-seconds
Specifies the WebSocket keep-alive ping interval for session terminals.
Type: int
Default: 10
websocket-connect-timeout
Specifies the WebSocket initial connection timeout in seconds for session terminals.
Type: int
Default: 3
websocket-log-level
Specifies the WebSocket log level for session terminals ((0=none, 1=errors, 2=activity, 3=all).
Type: int
Default: 0
websocket-handshake-timeout
Specifies the WebSocket protocol handshake timeout for session terminals in milliseconds.
Type: int
Default: 5000
package-output-to-package-folder
Specifies whether or not package builds output to the package project folder.
Type: bool
Default: 0
restrict-directory-view
Indicates whether or not to restrict the directories that can be viewed within the IDE.
Type: bool
Default: 0
directory-view-allow-list
Specifies a list of directories exempt from directory view restrictions, separated by a colon character (:).
Type: string
Default: <empty string>
session-port-range
Constrain the range of TCP ports available to the session. Accepts a range in the form ‘
Type: string
Default: <empty string>
session-ephemeral-env-vars
Specifies a list of environment variables that will not be saved when sessions suspend, separated by a colon character (:).
Type: string
Default: <empty string>
session-suspend-on-incomplete-statement
Specifies whether the session should be allowed to suspend when a user has entered a partial R statement.
Type: bool
Default: 0
session-async-rpc-enabled
Enables async responses to rpc requests to prevent connection logjams in the browser, allowing interrupt of busy sessions
Type: bool
Default: 1
session-async-rpc-timeout-ms
Duration in millis before requests are converted to async - i.e. how fast will the server free up connections when it’s busy
Type: int
Default: 200
session-handle-offline-enabled
Enables offline request handling. When the R process is busy, some requests are allowed to run
Type: bool
Default: 1
session-handle-offline-timeout-ms
Duration in millis before requests that can be handled offline are processed by the offline handler thread.
Type: int
Default: 200
session-project-user-data-dir
The folder in which RStudio should store user-specific project (.Rproj.user) data.
Type: string
Default: <empty string>
session-allow-project-user-data-dir-override
Whether or not users can override the default project (.Rproj.user) data directory via their own user preferences.
Type: bool
Default: 1
open-files
Files to open on session load.
Type: string
Default: <empty string>
allow Settings
allow-vcs-executable-edit
Indicates whether or not to allow editing of VCS (Version Control Systems) executables.
Type: bool
Default: 1
allow-r-cran-repos-edit
Indicates whether or not to allow editing of CRAN repositories.
Type: bool
Default: 1
allow-vcs
Indicates whether or not to allow the use of version control features.
Type: bool
Default: 1
allow-package-installation
Indicates whether or not to allow installation of packages from the packages pane.
Type: bool
Default: 1
allow-shell
Indicates whether or not to allow access to the shell dialog.
Type: bool
Default: 1
allow-terminal-websockets
Indicates whether or not to allow connections to terminal sessions with websockets.
Type: bool
Default: 1
allow-file-downloads
Indicates whether or not to allow file downloads from the files pane.
Type: bool
Default: 1
allow-file-uploads
Indicates whether or not to allow file uploads from the files pane.
Type: bool
Default: 1
allow-remove-public-folder
Indicates whether or not to allow removal of the user public folder.
Type: bool
Default: 1
allow-rpubs-publish
Indicates whether or not to allow publishing of content to external services.
Type: bool
Default: 1
allow-external-publish
Indicates whether or not to allow publishing of content to external services.
Type: bool
Default: 1
allow-publish
Indicates whether or not to allow publishing of content.
Type: bool
Default: 1
allow-presentation-commands
Indicates whether or not to allow presentation commands.
Type: bool
Default: 0
allow-full-ui
Indicates whether or not to allow full standalone UI mode.
Type: bool
Default: 1
allow-launcher-jobs
Indicates whether or not to allow running jobs via the Launcher.
Type: bool
Default: 1
r Settings
r-core-source
Specifies the Core R source path.
Type: string
Default: R
r-modules-source
Specifies the Modules R source path.
Type: string
Default: R/modules
r-session-package-archives
Specifies the R package archives path.
Type: string
Default: R/packages
r-libs-user
Specifies the R user library path.
Type: string
Default: <empty string>
r-cran-repos
Specifies the default CRAN repository.
Type: string
Default: <empty string>
r-cran-repos-file
Specifies the path to a configuration file which contains default CRAN repositories.
Type: string
Default: The first repos.conf file that is found within the XDG_CONFIG_DIRS environment, or /etc/rstudio/repos.conf if not XDG_CONFIG_DIRS are specified.
r-cran-repos-url
Specifies the URL to a configuration file which contains optional CRAN repositories.
Type: string
Default: <empty string>
r-auto-reload-source
Indicates whether or not to automatically reload R source if it changes during the session.
Type: bool
Default: 0
r-compatible-graphics-engine-version
Specifies the maximum graphics engine version that this version of RStudio is compatible with.
Type: int
Default: 16
r-resources-path
Specifies the directory containing external resources.
Type: string
Default: resources
r-doc-dir-override
Specifies the override for R_DOC_DIR (used for debug configurations).
Type: string
Default: <empty string>
r-restore-workspace
If set, overrides the user/project restore workspace setting. Can be 0 (No), 1 (Yes), or 2 (Default).
Type: int
Default: 2 (Default).
r-run-rprofile
If set, overrides the user/project .Rprofile run setting. Can be 0 (No), 1 (Yes), or 2 (Default).
Type: int
Default: 2 (Default).
limits Settings
limit-file-upload-size-mb
Sets a size limit in megabytes on files that are uploaded via the files pane.
Type: int
Default: 0
limit-cpu-time-minutes
Sets a limit in minutes for the amount of time top level R computations may run before being interrupted.
Type: int
Default: 0
limit-xfs-disk-quota
Indicates whether or not XFS quotas should be enforced when performing file operations via the files pane.
Type: bool
Default: 0
external Settings
external-consoleio-path
Specifies the path to the consoleio executable (Windows-only).
Type: string
Default: bin/consoleio.exe
external-gnudiff-path
Specifies the path to gnudiff utilities (Windows-only).
Type: string
Default: bin/gnudiff
external-gnugrep-path
Specifies the path to gnugrep utilities (Windows-only).
Type: string
Default: bin/gnugrep/3.0
external-sumatra-path
Specifies the path to SumatraPDF (Windows-only).
Type: string
Default: bin/sumatra
external-winutils-path
Specifies the path to Hadoop Winutils (Windows-only).
Type: string
Default: bin/winutils
external-hunspell-dictionaries-path
Specifies the path to hunspell dictionaries.
Type: string
Default: resources/dictionaries
external-mathjax-path
Specifies the path to the mathjax library.
Type: string
Default: resources/mathjax-27
external-pandoc-path
Specifies the path to pandoc binaries.
Type: string
Default: bin/quarto/bin/tools
external-quarto-path
Specifies the path to quarto binaries.
Type: string
Default: bin/quarto
external-node-path
Specifies the path to node binaries.
Type: string
Default: bin/node
external-copilot-agent-path
Specifies the path to the GitHub Copilot agent.
Type: string
Default: <empty string>
external-winpty-path
Specifies the path to winpty binaries.
Type: string
Default: bin
git Settings
git-commit-large-file-size
Warns when attempting to commit files larger than this size (in bytes; set 0 to disable).
Type: int
Default: 5242880
user Settings
show-user-identity
Indicates whether or not to show the user identity in the session UI.
Type: bool
Default: 1
copilot Settings
copilot-enabled
Indicates whether or not GitHub Copilot integration can be enabled.
Type: bool
Default: 0
copilot-proxy-url
The proxy URL that the Copilot agent should use for outgoing network requests. Only plain HTTP proxy URLs are supported.
Type: string
Default: <empty string>
copilot-auth-provider
The URL to the authentication provider to be used by GitHub Copilot.
Type: string
Default: <empty string>
copilot-ssl-certificates-file
The path to a file containing one or more trusted certificates in PEM format.
Type: string
Default: <empty string>
copilot-proxy-strict-ssl
Should the GitHub Copilot agent perform SSL certificate validation when forming web requests?
Type: bool
Default: 1
copilot-agent-helper
The path to an optional shell script, which when invoked, should start the GitHub Copilot agent.
Type: string
Default: <empty string>
misc Settings
tutorial-api-enabled
Enables/disables the tutorial API.
Type: bool
Default: 0
tutorial-api-parent-notify-enabled
Enables/disables tutorial API parent notification.
Type: bool
Default: 0
tutorial-api-client-origin
Specifies the tutorial API client origin.
Type: string
Default: <empty string>
nfs-acl-version
Specifies the protocol version for the NFS Access Control List to use with Project Sharing (nfsv3 or nfsv4).
Type: string
Default: <empty string>
nfs4-principal-type
Specifies the type of security principal to use with NFSv4 Access Control Lists (‘username’ or ‘uid’).
Type: string
Default: username
nfs4-domain
Specifies the domain for NFSv4 Access Control Lists. Needed when using Project Sharing on an NFSv4 share with username-style security principals.
Type: string
Default: <empty string>
project-sharing-enumerate-server-users
Indicates whether or not to enumerate the server’s user groups when determining the users available for Project Sharing. If disabled, enumerates the users that are present in the RStudio user database instead.
Type: bool
Default: 0
session-timeout-kill-hours
Specifies the amount of hours to wait before forcefully killing a running session after it has been idle.
Type: int
Default: 0