Intro to RStudio Cloud

How to setup RStudio Cloud for Collaboration

Team POL346 pol346.com (Princeton University, Department of Politics)princeton.edu/politics
2021-04-19

Please note, this is a DRAFT. If you have any difficulty or suggestions, feedback is welcome. Please email .

Basic Setup: Step by Step

  1. Go to https://rstudio.cloud.

  2. Click Sign up and create an account.

Entering Your Report Workspace (Standard)

For reports in POL346, you and your team will typically be assigned a workspace in which to work on your report. In the team assignment, you should see an invite link for an RStudio Cloud workspace next to your name.

If for some reason you are creating your own workspace, skip to “Setting Up Your Own Workspace.”

  1. Once you have signed into your RStudio Cloud account, click on the invite link and join the workspace.

  2. In “Projects,” click New Project to create your group’s report.

  3. Toward the top of the screen in your new project, click “Untitled Project” and rename your project (something like “Report2_proj” may work well).

  4. Adjust the settings to make sure your teammates can view and edit the project:

    • click the GEAR icon in the upper right of the window
    • click the ACCESS lock icon, and change the pop-up menu to EVERYONE in your workspace

Once this is finished, skip to “Uploading Files & Data.”

Setting Up Your Own Workspace (Beyond POL346)

  1. Once you have an account and are logged in to RStudio Cloud, click the three lines in the top left corner (next to “Your Workspace”).

In the left-hand sidebar menu, under “Spaces,” click New Space. This will create a workspace that allows multiple RStudio Cloud users to edit project files. (Projects created in the default workspace, “Your Workspace,” will only be editable by you.)

  1. Once you have entered your newly created workspace, click the GEAR icon in the upper right corner to name your workspace (something like “POL346”).

  1. After navigating back to “Projects,” click New Project.

  2. Toward the top of the screen in your new project, click “Untitled Project” and rename your project.

  3. Adjust the settings so you can share this project with teammates:

    • click the GEAR icon in the upper right of the window
    • click the ACCESS lock icon, and change the pop-up menu to EVERYONE in your workspace

  1. To invite your teammates to edit your project, you will have to invite them to the workspace. Navigate back to the workspace and click on Members at the top of the screen. Then click Add Member. Be sure to make your teammates “Admins” or “Moderators” so that they can edit projects created by you or other team members.

  1. See the GUIDE in the left navigation for more detail on sharing and saving or follow this link: https://rstudio.cloud/learn/guide

Uploading Files & Data

  1. To upload your Rmd files and data, find the FILES pane \(\rightarrow\) UPLOAD tab.

If you are having trouble reading in data, see this link: https://www.youtube.com/watch?v=GaUE-d7tnNo.

For more detail on uploading, see this link: https://support.rstudio.com/hc/en-us/articles/200713893-Uploading-and-Downloading-Files.

Note: According to the RStudio Cloud guide, “each project is allocated 3GB for files and data, and another 3GB for packages.” You may also find that uploading overly large data files may slow down your project’s loading and knitting times. To circumvent this, try to upload preprocessed “working” data rather than full “raw” datasets whenever possible.

  1. You will need to install packages. If you are only using a few packages, the fastest solution will be to run install.packages() for those specific packages.
    • A simple but slower solution is to install all the packages that we recommend for POL346 by copying and pasting the following command into your RStudio Cloud console (this will take a few minutes:
      source("http://pol346.com/POL346_2020_packages.R")

Tips for Team Management and Workflow