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
$ 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. 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
If you are a Pro customer you can contact our support team here: https://support.rstudio.com/hc
- Version of RStudio
- Output from sessionInfo() in standard R console
- Error information
- Error messages
- Log files
- Attempted steps taken to fix
- Have you successfully launched RStudio Workbench in the past?