Posit Workbench Administration

This module will provide you with the information to install and configure a single server installation of Posit Workbench.

Course Objectives

  • Provide you with a mental model of how Posit Workbench operates
  • Provide insights into how users utilize Posit Workbench and how to support them
  • Practice typical installation tasks for a Posit Workbench administrator
  • Highlight some best practices and strategies for the configuration of Posit Workbench

Time Commitment

Going through the entire training should take between 2 and 4 hours depending on your level of experience working with the command line and the topics covered in the documentation.

Pre-requisites

The course assumes you have some experience with Linux. Specifically, you will need to be comfortable:

  • Executing Linux commands
  • Navigating the file system from the terminal
  • Edit configuration files using vim or nano
  • Access and read server logs

Training Structure

This module starts with a general introduction to Posit Workbench that focuses on what is Workbench and how data science teams use it. After, you will go through a series of hands-on labs that guide you through the steps required to install and configure Posit Workbench.

Each section starts with required reading from the Admin Guide documentation. This reading helps you get familiar with the structure and content of the Admin Guide that you will rely on regularly as an Admin of the Posit products. We recommend you go through the required reading and read through all the hands-on lab instructions before starting the hands-on labs environment.

The hands-on labs are hosted on Instruqt. For each lab, you will have access to:

  • a terminal to interact with a virtual machine running Ubuntu 24.04
  • a tab will give you access to your installation of Posit Workbench (once you have installed and configured it correctly)
  • the website for this training
  • a timer that indicates how much time you have left before the session runs out.

Once you completed all the assignments listed in a lab, clicking the “Check” button (bottom right), will run a script that verifies that it is the case, and record your progress.

Content Overview

  1. Introduction - Learn about the architecture of Posit Workbench and how it handles user sessions
  2. Install Workbench
    • Lab 1 – Install Posit Workbench and R
    • Lab 2 – Install system dependencies, Python, Quarto
    • Lab 3 – Setting up HTTPS
    • Lab 4 – Setting up Authentication
    • Lab 5 – Setting up Repositories and deploying content to Workbench

Documentation

Posit Connect has several guides geared towards different user personas and subject matter. The Admin Guide is the primary guide to reference for matters related to managing a Posit Connect deployment. For a complete list of available documentation for Posit Connect, visit the All Documentation section of the Posit documentation site.

The Posit Connect user interface also has a Documentation section accessible from the left sidebar.

Admin Guide

The Admin Guide is the best resource on Posit Workbench for administrators. We encourage you to use this training as an opportunity to get comfortable using this reference! As you go through the labs included in this training, you will be asked to read sections of the Admin Guide to become familiar with its content.

User Guide

The User Guide is more for users of Posit Workbench, however, there are many subjects that crossover with the Admin Guide. We encourage you to read through it to better understand how the users you support use Workbench so you can support them better.

TipHow does this apply to me?

As an Admin, you will be spending lots of time with product documentation. Be sure to bookmark these links and familiarize yourself with the different guides.