Support

RStudio Server Will Not Start

Follow

If RStudio Server will not start after installation, please reference the following:

Verify 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, send them (in addition to older application logs) in a new support request with the details of your system.
(see Other Start-Up Problems below).

Check the version of R

RStudio requires R 2.11.1 (or higher) to run. Make sure your current installation meets this requirement. See our download page for additional details.

R built from source

If you built R from source, you need to ensure that it was built with the --enable-R-shlib configuration option.

Check where R is installed

RStudio will search for your installation of R in the traditional locations, such as

/usr/bin/R
/usr/local/bin/R

If R is installed in a non-traditional location, RStudio may have difficulties finding it. On Ubuntu, this is because RStudio Server 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:

/etc/apparmor.d/rstudio-server

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.

Check firewall and proxy settings

RStudio needs access to port 8787. Ensure there are no network settings or (software-based) firewalls blocking access to this port.

Restarting 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

Other Start-Up Problems

If you are still unable to start RStudio Server, 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 Server in the past?

Return to Troubleshooting Guide: Managing RStudio Server

Have more questions? Submit a request

Comments

Powered by Zendesk