Skip to content

Posit Team AWS CloudFormation template#

RStudio is now Posit!

Our professional products have been renamed to Posit Connect, Posit Workbench, Posit Package Manager, Posit Cloud, and Posit Academy so it’s easier for folks to understand that we support more than just R. Please review our Blog post/FAQ to answer commonly asked questions about the rebrand.

The Posit Team, formerly RStudio Team, AWS CloudFormation template provides a push-button deployment that ensures that you can quickly and easily spin up all of Posit’s Professional products using AWS for a 45-day evaluation or as a permanent deployment after activating a valid license.

The Posit Team AWS CloudFormation template spins up the necessary infrastructure that is required for a minimal working Posit Team deployment. The template uses AWS Amazon Machine Images (AMIs) that already have the products installed.

The created infrastructure consists of one EC2 Instance and one Security Group for each of the following:

  • Workbench
  • Connect
  • Package Manager

The AWS AMIs provide Posit Professional products, one version of R, and one version of Python ready to be used. These product installations can be customized and extended just like any other regular installation of Posit products. The installations of Posit Workbench and Posit Connect use the instance of Posit Package Manager deployed with the template as the only source of package installation, by default. You can change this within the template or once the products are deployed.

Prerequisites#

  • AWS account
  • AWS Virtual Private Cloud (VPC)
  • Subnet inside the selected VPC (If the subnet that you select is not in the VPC that is selected, then your deployment will fail)
  • AWS Key pair
  • Permissions to create security groups
  • Permissions to create EC2 instances

Note

The CloudFormation template requires a public VPC and a subnet with an Internet Gateway attached.

Step 1: Select Template#

  • Navigate to the Posit AWS CloudFormation template on the AWS CloudFormation website by clicking the Launch Stack Posit CloudFormation button.

  • If you are not currently logged into AWS, then use your AWS credentials to sign into AWS.

    Info

    Currently, the AWS CloudFormation template is available in all US, EU, and AP regions.

  • From the Create stack page, in the Specify template section, do the following:

  • Click Next. The Specify Details page displays.

Step 2: Specify Details#

  • In the Stack name section, assign a name to the stack. By default, the stack name is “RStudioTeam”.
  • In the Parameters section, refer to the tables below to specify the parameters for the RStudio cluster and the AWS resource configuration.

    Note

    You can use or change the default parameter values that are defined in the AWS CloudFormation template.


Global Network configuration#

Parameter Description
Deploy to VPC required - VPC for the RStudio cluster deployment.
Deploy to Subnet required - Subnet for the RStudio cluster deployment. The subnet must be in the selected VPC.
Security group CIDR Range for HTTP/HTTPS CIDR Range for ports 80 and 443 for all security groups (default: 0.0.0.0/0).
Security group CIDR Range for SSH CIDR Range for ports 22 for all security groups (default: 0.0.0.0/0).

Global EC2 resource configuration#

Parameter Description
AWS key pair required - The AWS key pair used for the Posit EC2 instances

Product specific parameters#

Specify parameters that are specific to Workbench, Connect, and Package Manager.

Note

The default parameters provided are the minimum that Posit recommends for more permanent deployments.

Parameter Description
Instance Type EC2 Instance type (default: m5.large)
Disk Size Root Volume Size (default and minimum: 50 GB or 120 GB for RSPM)

  • After you have confirmed and specified the parameters, click Next. The Options page displays.

Step 3: Options#

  • Make the to the changes Options page changes that you require for your stack and click Next. The Review page displays.

    Options page configuration options

    The Options page allows you to specify the stack’s:

    • Tags
    • Permissions
    • Rollback Triggers
    • Advanced options

    All of the options available for configuration are optional.

Step 4: Review and create#

  • Review the stack’s configuration and do one of the following:
    • If the configuration requires additional updates, then make the required updates and click Create.
    • If the configuration does not require additional updates, click Create.

Configure HTTPS [Optional]#

  • If you want to encrypt traffic in front of a load balancer, you can follow these detailed instructions for configuring HTTPS on EC2. In summary:

    • Request a public certificate from AWS Certificate Manager (ACM)
    • If you have not already created an Application Load Balancer (ALB) or Network Load Balancer (NLB), create a load balancer
    • Associate your certificate with the load balancer
    • Put the Amazon EC2 instance behind your load balancer
    • Route traffic to your load balancer by configuring DNS with Route 53

If you want to encrypt traffic to Posit professional products (e.g., behind a load balancer), you can configure SSL as described in our documentation. For issues, see the Troubleshooting SSL page.

Connect to Posit products#

  • From the AWS CloudFormation page:

    • Locate and select your stack’s corresponding check box.
    • Verify that your deployment is complete from the Status column.
    • Once your deployment is complete, select the Outputs tab.
    • Click the RStudio UI link to open the Posit Professional products in the browser.
Outputs
Parameter Description
RSWHost Public IP for RStudio Workbench
RSWDefaultUser RStudio Workbench default user (rstudio-user)
RSWDefaultPassword RStudio Workbench default user password (Instance ID for RSW)
RSCHost Public IP for RStudio Connect
RSPMHost Public IP for RStudio Package Manager

Getting Started with Posit Professional products#

For more information on using our products, see Posit Tutorials.

Default login credentials#

The default Workbench username is rstudio-user and the password is the EC2 instance ID. We recommend changing this after the initial deployment of the AWS CloudFormation template to a unique username and password.

There is no default Connect user; however, an administrator account can be set up from the initial login page.

Licensing#

After your 45-day evaluation period, you can activate your products with production licenses at any time without the need to reinstall or reconfigure anything.

Follow the documentation for each product:

Additional configuration#

To define additional configurations for options such as Authentication, SSL certificates and, etc., refer to the following Posit Documentation:

Product versions#

The CloudFormation template is updated with new releases of Posit Professional Products. The current versions are:

  • Workbench: 2022.07.0
  • Connect: v2022.08.0
  • Package Manager: v2022.07.2-11

Support#

If you find any issues launching the CloudFormation template you can contact Posit support.

  • File a Support ticket:

    • In your support ticket please included the following files from the EC2 instance that failed to create:
      • /var/log/first-boot.log
      • /var/log/user-data.log
    • In order to get the log files of the EC2 instances, navigate to Advanced options > Stack creation options and disable Rollback on failure.

    Disable
  rollback radio button selected