PACE Environment Setup

Intro

DSGT ARC environment setup including how to access the Phoenix Cluster

Python Setup

UV

• Install UV

curl -LsSf https://astral.sh/uv/install.sh | sh

Connect to VPN

• Install the GT VPN

SSH Setup

Configure SSH Host Aliases

• Create ~/.ssh/config file

Host pace
    HostName login-phoenix.pace.gatech.edu
    User your_username
 
Host pace-interactive
    HostName atl1-1-02-018-19-1.pace.gatech.edu
    User your_username
    ProxyJump pace

Set up password-less SSH login

• Check for existing SSH key ¹

ls -al ~/.ssh

• Copy public key

cat ~/.ssh/id_ed25519.pub

• log in to Pace

ssh pace

• Append copied public key to authorized_keys file

nano ~/.ssh/authorized_keys

• Set correct permissions

chmod 700 ~/.ssh
chmod 600 ~/.ssh/authorized_keys

• Exit SSH session and test log in

ssh pace

Log in to PACE using SSH

• Open a Linux terminal while connected to the VPN and log in PACE using SSH ²

ssh someuser3@login-phoenix.pace.gatech.edu

WSL

Configure Windows Subsystem for Linux to Access Phoenix

• Please refer to the Windows Subsystem for Linux Page in the Getting Started section for a detailed guide that also applies to the Phoenix Cluster.
• Instead of using someuser3@login-s.pace.gatech.edu to log into the cluster, please use someuser3@login-p.pace.gatech.edu, replacing someuser3 with your GT username.

Remote SSH into PACE with VS Code

• Install Remote SSH extension remote-ssh-extension

• In the Command Pallette, type “Remote-SSH: Connect to Host”

WSL workaround

• Create symlink New-Item -ItemType SymbolicLink -Path "C:\home\ubu24\.ssh\config" -Target "\\wsl.localhost\Ubuntu-24.04\home\ubu24\.ssh\config"
• Open VS Code from WSL, Click Remote Explorer → Remotes (Tunnels/SSH) → SSH, click the gear icon, then specify custom config file as /home/username/.ssh/config

Git and GitHub Setup

• Check Git configurations, including user name and email

git config --list

• Configure Git user information

git config --global user.email "you@gatech.edu"
git config --global user.name "Your Name"

• In pace-interactive, create folder

cd ~
mkdir -p dsgt/arc

• Fork the repo and clone your fork

git clone git@github.com:username/fall-2025-interest-group-projects.git
ls -la

• Add upstream remote to pull updates from original repo

git remote add upstream git@github.com:dsgt-arc/fall-2025-interest-group-projects.git
git remote -v

• Create a branch (ex initials/lora)

Footnotes

1. https://docs.github.com/en/authentication/connecting-to-github-with-ssh/checking-for-existing-ssh-keys#checking-for-existing-ssh-keys ↩

2. https://gatech.service-now.com/home?id=kb_article_view&sysparm_article=KB0041969#log-into-phoenix-using-ssh ↩