If RStudio Server will not start after installation, please reference the following:
To ensure that RStudio has installed correctly, run the verify-installation command:
$ sudo rstudio-server verify-installation
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
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:
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:
- Version of RStudio
- Output from
sessionInfo()in standard R console
- General description
- Error messages
- Log files (See here)
- Attempted steps taken to fix
- Have you successfully launched RStudio Server in the past?