command-line options: verify: --verify-installation arg (=0) Verifies that the session installation is working correctly and exits. version: --version [=arg(=1)] (=0) Prints the version number and exits. automation: --automation-agent [=arg(=1)] (=0) Run RStudio as an automation agent. tests: --run-tests [=arg(=1)] (=0) Runs unit tests and exits. script: --run-script arg Runs an R script and exits. program: --program-mode arg (=server) The program mode the session is running in (desktop or server). log: --log-stderr arg (=0) Writes log entries to stderr in addition to any other configured log destinations. docs: --docs-url arg If specified, overrides the URL to navigate to when a user clicks on the RStudio help link. www: --www-local-path arg (=www) The relative path from the RStudio installation directory, or absolute path where web assets are stored. --www-symbol-maps-path arg (=www-symbolmaps) The relative path from the RStudio installation directory, or absolute path, where symbol maps are stored. --www-port arg (=8787) The HTTP port to listen on for incoming connections. This is generally only used with Launcher sessions. --www-address arg (=127.0.0.1) The address to listen on for incoming connections. This is generally only used with Launcher sessions. --standalone arg (=0) Runs the session in standalone mode, indicating we should use HTTP communication. This is generally only used with Launcher sessions. --verify-signatures arg (=0) Indicates whether or not to verify signatures on incoming requests. This is generally only used with Launcher sessions. --www-reuse-ports arg (=0) Whether or not to reuse last used bound ports when restarting a Launcher session. --disable-new-csrf-checks arg (=0) Certain rpc calls were missing checks for the CSRF token to prevent misuse of these api in a context with lax SameSite cookie policies. Use this option temporarily to override these new checks if you have integrations that rely on the old behavior. session: --session-connections-block-suspend arg (=1) Whether or not an active database connection should block attempts to suspend the session after timeout. --session-external-pointers-block-suspend arg (=1) Whether or not R objects containing external pointers should block attempts to suspend the session after timeout. --session-timeout-minutes arg (=120) The amount of minutes before a session times out, at which point the session will either suspend or exit. --session-timeout-suspend arg (=1) 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. --session-disconnected-timeout-minutes arg (=0) 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 --session-preflight-script arg Sets a script to be run on startup before any R initialization has occurred. --session-create-public-folder arg (=0) 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. --session-create-profile arg (=0) 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. --session-rprofile-on-resume-default arg (=0) Specifies the default user setting for running the Rprofile when sessions are resumed. --session-save-action-default arg Specifies the default save action (yes, no, or ask). --session-default-working-dir arg Specifies the default working directory to use for new sessions. --session-default-new-project-dir arg (=~) Specifies the default directory to use for new projects. --show-help-home arg (=0) Indicates whether or not to show the help home page on startup. --session-default-console-term arg (=xterm-256color) Specifies the default TERM setting for the R console. --session-default-clicolor-force arg (=1) Specifies the default CLICOLOR_FORCE setting for the R console. --session-quit-child-processes-on-exit arg (=0) 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. --session-first-project-template-path arg 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. --default-rsconnect-server arg Specifies the default Posit Connect server URL. --terminal-port arg If specified, sets the port to bind the terminal server to. This should generally only be set for containerized Launcher sessions, where the port must be known. --websocket-ping-seconds arg (=10) Specifies the WebSocket keep-alive ping interval for session terminals. --websocket-connect-timeout arg (=5) Specifies the WebSocket initial connection timeout in seconds for session terminals. --websocket-log-level arg (=0) Specifies the WebSocket log level for session terminals ((0=none, 1=errors, 2=activity, 3=all). --websocket-handshake-timeout arg (=5000) Specifies the WebSocket protocol handshake timeout for session terminals in milliseconds. --package-output-to-package-folder arg (=0) Specifies whether or not package builds output to the package project folder. --session-root-path arg (=/) The path prefix added by a proxy to the incoming RStudio URL. This setting is used so RStudio Server knows what path it is being served from. If running RStudio Server behind a path-modifying proxy, this should be changed to match the base RStudio Server URL. --session-use-secure-cookies arg (=0) Indicates whether or not to mark cookies as secure. --session-same-site arg (=0) The value of the SameSite attribute used in cookie issued by the session. --session-www-frame-origin arg The www-frame-origin value forwarded from rserver, used for CSP frame-ancestors directives. --restrict-directory-view arg (=0) Indicates whether or not to restrict the directories that can be viewed within the IDE. --directory-view-allow-list arg Specifies a list of directories exempt from directory view restrictions, separated by a colon character (:). --session-port-range arg Constrain the range of TCP ports available to the session. Accepts a range in the form '-', e.g. 59000-59999. --session-ephemeral-env-vars arg Specifies a list of environment variables that will not be saved when sessions suspend, separated by a colon character (:). --session-suspend-on-incomplete-statement arg (=0) Specifies whether the session should be allowed to suspend when a user has entered a partial R statement. --session-async-rpc-enabled arg (=1) Enables async responses to rpc requests to prevent connection logjams in the browser, allowing interrupt of busy sessions --session-async-rpc-timeout-ms arg (=200) Duration in millis before requests are converted to async - i.e. how fast will the server free up connections when it's busy --session-handle-offline-enabled arg (=1) Enables offline request handling. When the R process is busy, some requests are allowed to run --session-handle-offline-timeout-ms arg (=200) Duration in millis before requests that can be handled offline are processed by the offline handler thread. --session-use-file-storage arg (=1) Controls whether the session should store its metadata on the file system or send it to the server to be stored in the internal database. --session-project-user-data-dir arg The folder in which RStudio should store user-specific project (.Rproj.user) data. --session-allow-project-user-data-dir-override arg (=1) Whether or not users can override the default project (.Rproj.user) data directory via their own user preferences. --open-files arg Files to open on session load. allow: --allow-vcs-executable-edit arg (=1) Indicates whether or not to allow editing of VCS (Version Control Systems) executables. --allow-r-cran-repos-edit arg (=1) Indicates whether or not to allow editing of CRAN repositories. --allow-vcs arg (=1) Indicates whether or not to allow the use of version control features. --allow-package-installation arg (=1) Indicates whether or not to allow installation of packages from the packages pane. --allow-package-source-recording arg (=1) Indicates whether or not to annotate the DESCRIPTION file of packages installed via install.packages() with their repository source (RemoteType, RemoteRepos, etc). --allow-shell arg (=1) Indicates whether or not to allow access to the shell dialog. --allow-terminal-websockets arg (=1) Indicates whether or not to allow connections to terminal sessions with websockets. --allow-file-downloads arg (=1) Indicates whether or not to allow file downloads from the files pane. --allow-file-uploads arg (=1) Indicates whether or not to allow file uploads from the files pane. --allow-remove-public-folder arg (=1) Indicates whether or not to allow removal of the user public folder. --allow-rpubs-publish arg (=1) Indicates whether or not to allow publishing of content to external services. --allow-external-publish arg (=1) Indicates whether or not to allow publishing of content to external services. --allow-publish arg (=1) Indicates whether or not to allow publishing of content. --allow-presentation-commands arg (=0) Indicates whether or not to allow presentation commands. --allow-full-ui arg (=1) Indicates whether or not to allow full standalone UI mode. --allow-launcher-jobs arg (=1) Indicates whether or not to allow running jobs via the Launcher. --allow-over-limit-sessions arg (=0) Indicates whether or not to abort sessions that exceed their specified memory limit. Users will still see warnings and an error. --abort-free-mem-percent arg (=5) Sessions will be aborted if there is less than 100 MiB of free RAM or this configured percentage. Disable abort entirely by enabling allow-over-limit-sessions. Increase this value for easily reproducing this scenario in a test environment or to more strictly enforce memory limits on the system. --allow-copilot arg (=1) Indicates whether or not to allow use of Copilot-related features. --allow-posit-assistant arg (=0) Indicates whether or not to allow use of Posit Assistant features. r: --r-core-source arg (=R) Specifies the Core R source path. --r-modules-source arg (=R/modules) Specifies the Modules R source path. --r-session-library arg (=R/library) Specifies the R library path. --r-session-package-archives arg (=R/packages) Specifies the R package archives path. --r-libs-user arg Specifies the R user library path. --r-cran-repos arg Specifies the default CRAN repository. --r-cran-repos-file arg (=/etc/rstudio/repos.conf) Specifies the path to a configuration file which contains default CRAN repositories. --r-cran-repos-url arg Specifies the URL to a configuration file which contains optional CRAN repositories. --r-auto-reload-source arg (=0) Indicates whether or not to automatically reload R source if it changes during the session. --r-compatible-graphics-engine-version arg (=17) Specifies the maximum graphics engine version that this version of RStudio is compatible with. --r-resources-path arg (=resources) Specifies the directory containing external resources. --r-shell-escape arg (=0) Indicates whether or not to support shell escape. --r-home-dir-override arg Specifies the override for R_HOME (used for debug configurations). --r-doc-dir-override arg Specifies the override for R_DOC_DIR (used for debug configurations). --r-restore-workspace arg (=2) If set, overrides the user/project restore workspace setting. Can be 0 (No), 1 (Yes), or 2 (Default). --r-run-rprofile arg (=2) If set, overrides the user/project .Rprofile run setting. Can be 0 (No), 1 (Yes), or 2 (Default). --r-max-connections arg (=0) Sets the maximum number of connections that R will support. Valid values are 128 to 4096. When set, the value is applied to the R startup parameters. If set to 0 (the default), the R default (128) will be used. Requires R >= 4.4.0. limits: --limit-file-upload-size-mb arg (=0) Sets a size limit in megabytes on files that are uploaded via the files pane. --limit-cpu-time-minutes arg (=0) Sets a limit in minutes for the amount of time top level R computations may run before being interrupted. --limit-xfs-disk-quota arg (=0) Indicates whether or not XFS quotas should be enforced when performing file operations via the files pane. --memory-usage-mode arg (=auto) Selects how Posit Workbench computes and reports session and total memory usage. 'auto' (the default) uses 'container' when the session runs inside a container and 'default' otherwise. 'default' preserves the historical behavior: total memory is the node's physical or cgroup RAM, and Workbench aborts sessions based on node free memory plus a grace period. 'container' reports the session's cgroup memory limit as the total. 'cgroup' reads memory usage from the cgroup. 'meminfo' reads memory usage from the node's /proc/meminfo (useful when cgroup memory includes file cache that does not reflect actual session use). external: --external-rpostback-path arg (=bin/rpostback) Specifies the path to the rpostback executable. --external-consoleio-path arg (=bin/consoleio.exe) Specifies the path to the consoleio executable (Windows-only). --external-gnudiff-path arg (=bin/gnudiff) Specifies the path to gnudiff utilities (Windows-only). --external-gnugrep-path arg (=bin/gnugrep/3.0) Specifies the path to gnugrep utilities (Windows-only). --external-msysssh-path arg (=bin/msys-ssh-1000-18) Specifies the path to msys_ssh utilities (Windows-only). --external-sumatra-path arg (=bin/sumatra) Specifies the path to SumatraPDF (Windows-only). --external-winutils-path arg (=bin/winutils) Specifies the path to Hadoop Winutils (Windows-only). --external-hunspell-dictionaries-path arg (=resources/dictionaries) Specifies the path to hunspell dictionaries. --external-mathjax-path arg (=resources/mathjax-27) Specifies the path to the mathjax library. --external-mathjax4-path arg (=resources/mathjax-4) Specifies the path to the mathjax 4 library. --external-pandoc-path arg (=bin/quarto/bin/tools) Specifies the path to pandoc binaries. --external-quarto-path arg (=bin/quarto) Specifies the path to quarto binaries. --external-copilot-path arg (=bin/copilot-language-server-js) Specifies the path to Copilot Language Server JavaScript distribution. --external-node-path arg (=bin/node) Specifies the path to node binaries. --external-copilot-agent-path arg Specifies the path to the GitHub Copilot agent. --external-libclang-path arg (=bin/rsclang) Specifies the path to the libclang shared library --external-libclang-headers-path arg (=resources/libclang/builtin-headers) Specifies the path to the libclang builtin headers. git: --git-commit-large-file-size arg (=5242880) Warns when attempting to commit files larger than this size (in bytes; set 0 to disable). user: -u [ --user-identity ] arg (=nobody) The user identity for the session. --show-user-identity arg (=1) Indicates whether or not to show the user identity in the session UI. -p [ --project ] arg Specifies the active project. -s [ --scope ] arg Specifies the session identifier. --launcher-token arg Specifies the token identifying the session launcher. pai: --posit-assistant-enabled arg (=1) Indicates whether or not Posit Assistant integration can be enabled. --posit-assistant-installation-enabled arg (=1) Indicates whether or not users may install and update Posit Assistant themselves. When disabled, the session uses only an administrator-managed installation, ignores any user-level installation, and performs no update checks. --posit-assistant-ssl-certificates-file arg The path to a file containing one or more trusted certificates in PEM format. --posit-assistant-helper arg The path to an optional shell script, which when invoked, should start the Posit Next Edit Suggestions Language Server. --posit-assistant-test-manifest [=arg(=1)] (=0) Use the test manifest URL for Posit Assistant package updates. --posit-assistant-path arg No longer used. Accepted so that configuration files which set it still parse; administrator-installed Posit Assistant versions are read from the posit-assistant directory beside the session binary. copilot: --copilot-enabled arg (=0) Indicates whether or not GitHub Copilot integration can be enabled. --copilot-proxy-url arg The proxy URL that the Copilot agent should use for outgoing network requests. Only plain HTTP proxy URLs are supported. --copilot-auth-provider arg The URL to the authentication provider to be used by GitHub Copilot. --copilot-proxy-kerberos-service-principal arg The Kerberos service principal to use for authenticating GitHub Copilot with the proxy. --copilot-ssl-certificates-file arg The path to a file containing one or more trusted certificates in PEM format. --copilot-proxy-strict-ssl arg (=1) Should the GitHub Copilot agent perform SSL certificate validation when forming web requests? --copilot-agent-helper arg The path to an optional shell script, which when invoked, should start the GitHub Copilot agent. --copilot-helper arg The path to an optional shell script, which when invoked, should start the GitHub Copilot Language Server. trust: --project-trust-dialogs arg (=-1) When enabled (1), RStudio will prompt users to trust project directories that contain auto-executing files (.Rprofile, .RData, .Renviron). When disabled (0), all directories are implicitly trusted. When unset (-1), the default depends on the edition of RStudio. --project-trust-required [=arg(=1)] (=0) When enabled, projects are treated as untrusted by default: users are prompted to trust each project when it is opened (including projects in the user's home directory), even if it contains no auto-executing files. Projects that have not been explicitly trusted run in restricted mode. Setting this option implies project-trust-dialo gs; if that option has been explicitly disabled, this option has no effect. --preview-allowed-functions arg A comma- or space-separated list of additional function names (for example, 'mypkg::connect') that may be evaluated without prompting when resolving a file preview connection expression -- the SQL '-- !preview conn=' header or an r2d3 preview. Each listed name is treated as a trusted constructor; its arguments are still validated. Use this to allow connection helpers from internally-built packages. misc: --track-resource-downloads arg (=0) When enabled, downloads of browser-renderable resources (fonts, images, HTML, and other inline content types served via /files, /file_show, and /show) generate session_file_downlo ad audit events instead of being skipped. Defaults to disabled to avoid audit noise from routine resource loads. Administrators who require these downloads to be audited can enable this option. general: --help print help message --test-config deprecated alias for --check-config --check-config validate the configuration file and report all unrecognized options in a single pass --setup-db create the product database, service user, and grants on a PostgreSQL server --setup-db-master-password-file arg path to a file whose first line is the --setup-db master database password --setup-db-show-password print the generated service-user password to stdout when running --setup-db --setup-db-print-only write --setup-db credentials to a standalone file instead of the product config file --setup-db-host arg PostgreSQL host for --setup-db (skips the interactive prompt when set) --setup-db-port arg PostgreSQL port for --setup-db (skips the interactive prompt when set) --setup-db-master-username arg PostgreSQL master username for --setup-db (skips the interactive prompt when set) --setup-db-database-name arg database name for --setup-db (skips the interactive prompt when set) --setup-db-database-user arg database user for --setup-db (skips the interactive prompt when set) --config-file arg configuration file