RStudio QuickStart Troubleshooting

RStudio QuickStart is a virtual machine that runs on Mac and Windows desktops. The QuickStart lets you experience RStudio professional products without ever having to set up a server. This document troubleshoots common issues. Please refer to the RStudio Community for help with specific issues. 

Getting Started

Installation requirements

RStudio Quickstart requires a desktop capable of running VirtualBox, an Internet connection, and 15 Gb of disk space. Note: You must use VirtualBox, no other virtualization software is designed to work with the QuickStart.

My VirtualBox installation failed on Mac

If you see the following error when installing VirtualBox on Mac, you may need to alter your security and privacy settings. There is a nice write up on how to solve this issue on Medium.


I cannot open the QuickStart (*.ova) download

Do not need to double-click the (*.ova) file. You can import the QuickStart (*.ova) from within Virtualbox. First, open VirtualBox. Second, select File > Import Appliance. Third, navigate the VirtualBox wizard to the QuickStart (*.ova) download.

The QuickStart hangs when starting up

In this situation, the QuickStart has no services listening (on port 5000 or otherwise) and does not allow you to connect with a terminal. As with many of these VirtualBox issues, retrieving the log files can help you debug.

TM: Host/VM is not suitable

If you see an issue where TM (time manager) fails to switch from Dynamic to RealTscOffset in the log, unfortunately, we have not found a solution yet.

TM: Host/VM is not suitable for using TSC mode 'RealTscOffset', 
request to change TSC mode ignored

I cannot publish to RStudio Connect from my desktop

One of the common reasons that this fails is that the clock is out of sync on the QuickStart (common for VirtualBox instances). From a shell inside the QuickStart, you can execute timedatectl to see the state of the system clock.

If it is out of sync, check the state of the clock synchronization service with:

sudo systemctl status chrony

Or try to force a clock sync with:

sudo chronyc makestep

Once the clock is in sync (which usually takes a little while), publishing should work fine.

RStudio Connect, RStudio Package Manager, or RStudio Server Pro is not starting

This could happen for many reasons. Please check your connection to the Internet and restart the QuickStart. If that doesn't work, clear your browser history and try again. Or power off the machine and import a the (*.ova) download anew.

RStudio runs slowly inside the QuickStart

RStudio professional products are designed to run on dedicated servers. Your desktop should be powerful enough to run VirtualBox, RStudio, and R. 

Installing packages takes a long time

Installing R packages on Linux servers takes longer than on your desktop, because on Linux the package source code must be compiled. The QuickStart contains a minimal set of R packages. Installing new R packages may require significant time to download and compile.

I cannot run the QuickStart offline

The Quickstart requires an Internet connection so that the licenses can be activated. The RStudio products in the Quickstart are licensed for 45 days. Make sure you are connected to the Internet when you set up the QuickStart.