RStudio Desktop will not start

Below is a list of common start-up problems. If one of the following does not describe your problem, see Other start-up issues for next steps.

Check the version of R

RStudio requires R version 3.6.0, or higher, to run. Ensure your current installation meets this requirement. If not, please download and install R from https://cran.r-project.org.

On Windows, if you have multiple versions of R installed, you can press and hold Ctrl when starting RStudio to select your version of R.

Check for Startup files

The R code within these files may be causing an error. So, try removing all startup files such as .Rprofile, .Renviron, and .RData from your initial working directory. If RStudio successfully starts after removing these files, try to pinpoint which file resulted in the error. If you are able to determine the source of the problem, please notify Support with the details. Be sure to include the steps to reproduce this error (including necessary code).

RStudio cannot find R

If you installed R to a non-default location, it is possible RStudio cannot find R on your machine. Open a standard console session and type the following command at the console:

> Sys.which("R")

The displayed location must be in your search path for RStudio to successfully bind to your R installation.

On Windows, you can force RStudio to bind to a specific version of R by pressing and holding Ctrl when starting RStudio.

Check firewall, proxy settings, and antimalware

Although RStudio does not require internet access, it does use a localhost connection to link your R session with the RStudio IDE. As a result, it is possible a (software-based) firewall, network setting, or antimalware program is blocking access to RStudio. If you have a firewall, HTTP or HTTPS proxy configured, add localhost and 127.0.0.1 to the list of approved hosts and domains. Then, restart RStudio. If you have antimalware software configured that may be blocking RStudio, please check its settings and allow-list RStudio, if necessary.

Check the permissions on the ~/.rstudio-desktop directory

RStudio saves some session files in the ~/.rstudio-desktop directory. If this directory has its permissions changed, RStudio may not have read and write access for that folder and may fail to start. Check the permissions and make sure the folder has read, write, and execute permissions. If not, change the permissions or reset RStudio’s state as described below.

Reset RStudio’s state

In some cases, it is necessary to reset RStudio’s state analogous to a fresh installation. To do this, see the Resetting RStudio’s State.

Other start-up issues

If you are unable to start RStudio and are using the open-source version, please open a new topic in https://forum.posit.co and provide any relevant details as noted below.

System information

Upload a diagnostic report and the output from the associated terminal session to a service like Gist and include the link.

Error information

  • General description
  • The version of RStudio you are trying to launch
  • Error messages
  • Log files
  • Attempted steps taken to fix
  • Have you successfully launched RStudio in the past?
Back to top