RStudio Workbench / RStudio Server Pro will not start

Avatar
Nathan Stephens
Follow

If RStudio Workbench (previously RStudio Server Pro) will not start after installation, please reference the following. If you are a pro-customer, you may also choose to contact professional support. When creating a support ticket make sure to include system information and a general description (see the general guidelines for submitting support tickets).

1. Verify the installation

To ensure that RStudio has installed correctly, run the verify-installation command:

$ sudo rstudio-server verify-installation

If you are a Pro customer and unable to resolve any outputted errors, include them and the log files in a support ticket.

2. Check requirements

RStudio requires a previous installation of R version 3.0.1 or higher. If you’re using openSUSE/SLES you also need to install the libgfortran43.

$ sudo zypper install libgfortran43

3. Check where R is installed

RStudio Workbench automatically scans for versions of R at the following locations:

/usr/lib/R
/usr/lib64/R
/usr/local/lib/R
/usr/local/lib64/R
/opt/local/lib/R
/opt/local/lib64/R
/opt/R
/opt/local/R

If R is installed in a non-traditional location, RStudio may have difficulties finding it. More information on R versions can be found here.

4. Check building R from source

If you build R from source, ensure that you have the build dependencies required for R and that you configured the build with –enable-R-shlib. For more information, refer to Installing Multiple Versions of R.

5. Check firewall and proxy settings

By default, RStudio needs access to port 8787. Ensure there are no network settings or (software-based) firewalls blocking access to this port. Occasionally, all ports are blocked except for port 80. If this is the case, you can change the default port in the /etc/rstudio/rserver.conf configuration file:

www-port=80

6. Restart the server

After making changes to the server or upgrading the version of R, you will need to restart the server with the following:

$ sudo rstudio-server restart

General guidelines for submitting support tickets/getting additional help

RStudio Workbench Pro Customers:

If you are a Pro customer you can contact our support team here:  https://support.rstudio.com/hc /en-us/requests/new. When creating a support ticket make sure to include system information and a general description. Include any log files or screenshots that help illustrate the issue.

System information

  • Version of RStudio
  • Output from sessionInfo() in standard R console
  • Error information

General description

  • Error messages
  • Log files
  • Attempted steps taken to fix
  • Have you successfully launched RStudio Workbench in the past?

Open-source users:

If you are still unable to start RStudio Workbench, open a new discussion and provide any relevant details as noted below:

System information

  • Version of RStudio
  • Output from sessionInfo() in standard R console

Error information

  • General description
  • Error messages
  • Log files (See here)
  • Attempted steps taken to fix
  • Have you successfully launched RStudio Workbench in the past?

Return to Troubleshooting Guide: Managing RStudio Workbench

 

Comments