Posit (formerly RStudio) Workbench Server will not start

Avatar
Nathan Stephens
Follow

If Posit Workbench 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 the installation was successful, 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

Posit 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

Posit 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, there may be 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, Posit 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

Posit 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 Posit Workbench in the past?

Open-source users:

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

System information

  • Version of Posit
  • 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 Workbench in the past?

Return to Troubleshooting Guide: Managing Posit Workbench

 

Comments