README.md

Mach 30 Python Workspace (Kasm Image)

Introduction

This repo provides a workspace for Mach 30 volunteers to work on Python projects based on the Ansible based template for KASM Ubuntu Focal Images template provided by @j-simmons-phd. The workspace is configured with the following software:

• git cli
• Keychain
• Chrome
• Python 3.8.x (part of the image template) with the following packages (not part of the image template)
  • pip
  • JupyterLab
  • Jupyter Notebook
  • Voilà
  • Pint
• VS Code with the following extensions (note, auto-updates are disabled)
  • Python extension by Microsoft

How to Use this Repo

1. Clone this repo, giving the new repo a descriptive name for the workspace image to be created
2. Run docker-compose pull to download the image or run docker-compose build to build the workspace image

Using the image locally

Once built, the image can be pushed into the Kasm server per Kasm documentation or it can be run locally on port 6901 using docker-compose.

• Starting the image locally: Run docker-compose up -d
• Stopping the image locally: Run docker-compose down

When running locally, the workspace can be accessed at https://localhost:6901 with

• User: kasm_user
• Passwordd: password