Skip to content

Troubleshooting Launcher and Kubernetes:
Check Log Files#

RStudio Workbench generates log files for each component, including the RStudio Server Pro service, the Launcher service, the Kubernetes plugin, and individual sessions.

You can inspect the content of these log files for any relevant messages to help you determine the underlying cause of the error or issue that you are experiencing.

Server log files#

View the contents of the following log files on the server:

  • RStudio Workbench service:


  • Launcher service:


  • Kubernetes plugin:


Session log files#

If you are able to start remote sessions in Kubernetes, you can also view the logs for individual sessions using the following steps:

  1. From the RStudio Workbench home page, click + New Session:

    RStudio Workbench Home Page - New Session Button

  2. Start a new session in Kubernetes (you may wish to clear Join session when ready):

    RStudio Workbench Home Page - New Session Dialog Box

  3. Click the Info button next to the running session:

    RStudio Workbench Home Page - Info Button

  4. In the Session Info dialog box, select the Launcher Diagnostics tab:

    RStudio Workbench Home Page - Launcher Diagnostics Tab in Session Info Dialog Box

  5. In the Launcher Diagnostics tab, click the Details link:

    RStudio Workbench Home Page - Details Link in Session Info Dialog Box

The resulting page includes the logs from the remote session in Kubernetes:

RStudio Workbench Home Page - Session Logs on RStudio Session Page

Diagnostics report#

You can use the following command to generate a diagnostics report that includes logs for RStudio Workbench and Launcher as well as additional information about your system.

$ sudo rstudio-server run-diagnostics

The output of this command will show a location on disk where you can view the contents of the diagnostics report.

Restart services and test#

After reviewing the logs then identifying and correcting any issues, you can restart the RStudio Workbench and Launcher services:

$ sudo rstudio-server restart
$ sudo rstudio-launcher restart

Verify that the services are running and try to start a new session from the RStudio Workbench home page.

If the services are still not starting or you are still experiencing errors when starting a new session, then proceed to
Step 2 - Verify Installation.