RStudio Workbench / RStudio Server Pro will not start


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 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 2.11.1 or higher. If you’re using openSUSE/SLES you also ned 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:


If R is installed in a non-traditional location, RStudio may have difficulties finding it. On Ubuntu, this is because RStudio Workbench runs under an AppArmor profile which may be restricting access to that location. To resolve this, you can either add this location to your AppArmor profile or disable AppArmor entirely. Note that disabling AppArmor is not recommended for security reasons.

The RStudio AppArmor profile (Ubuntu only) is located at:


Modify the RStudio AppArmor profile (example lines below), with the correct location of the R executable and R home directory

/usr/bin/R rix, 
/usr/lib64/R/ r,
/usr/lib64/R/** rmix,

To activate these changes, reload AppArmor with the following command:

$ sudo invoke-rc.d apparmor reload

To permanently disable the RStudio AppArmor profile use the following commands:

$ sudo ln -s /etc/apparmor.d/rstudio-server /etc/apparmor.d/disable/
$ sudo apparmor_parser -R /etc/apparmor.d/rstudio-server

Additional documentation on AppArmor 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:


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

If you are a Pro customer you can contact our support team here: 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?