Troubleshooting

Overview

Posit Connect includes tools to help with troubleshooting common server issues.

Diagnostic Script

A diagnostic script is provided in /opt/rstudio-connect/scripts/run-diagnostics.sh. This script will gather information about the server, the Connect installation, and associated log files. You can run this script with this command, changing the output path as appropriate:

sudo /opt/rstudio-connect/scripts/run-diagnostics.sh \
    /full/path/to/output/directory

Review the contents of the output directory and feel free to sanitize any data you feel is sensitive.

System Checks

Posit Connect System Checks perform additional tests of the running Connect server and its process execution environments. Connect administrators can run these tests and view or download system check results.

Manually trigger system checks from the Admin tab in the Connect dashboard.

You can also schedule the internal checks to run periodically, by configuring one or both of the settings:

; /etc/rstudio-connect/rstudio-connect.gcfg
[Server]
SystemCheckOnStartup = true
SystemCheckFrequency = 3d