Connecting to TP Stack¶
Accept Your Invitation¶
You received an email from tpstackwaldur@gmail.com with the subject "TP-Stack Lab Invitation".
- Open the email.
- Click the invitation link.
- You land on the TP-Stack portal.
- Click "Accept invitation".
- Click "TP-Stack SSO" to log in.
If you already have an account, log in. If you're new, click "Register" (see below).
Note
The invitation link expires after 7 days. Check your spam/promotions folder if you don't see the email.
Register Your Account¶
On the Keycloak login page, click "Register" (link below the login form).
Fill in the following:
| Field | What to enter |
|---|---|
| Username | Choose a short username (e.g. jsmith). This becomes your SSH login — keep it lowercase, no spaces, no special characters. |
| Your real email (must match the invitation) | |
| First name | Your first name |
| Last name | Your last name |
| Password | Choose a strong password |
Click Register. You'll be redirected to the TP-Stack portal and should see your project.
Important
Remember your username and password — you'll need them to access the portal inorder to view your accounting and billing.
Explore the Portal¶
After logging in you'll see your organisation and project. You can view project members, resource allocations, and cluster status.
- Portal: https://waldur-portal.tp-stack.co.uk
- Monitoring: https://grafana-monitoring.tp-stack.co.uk
To log in again later, click "TP-Stack SSO" and enter your username and password.
Set Up SSH Access¶
Your admin will confirm SSH access within a day of your registration. You need to do three things (all one-time setup).
Install cloudflared¶
Download the .msi from the cloudflared releases page.
Verify:
Generate your SSH key¶
Press Enter twice (empty passphrase is fine).
This creates two files:
| File | What it is |
|---|---|
~/.ssh/tpstack |
PRIVATE key — never share this! |
~/.ssh/tpstack.pub |
PUBLIC key — send this to your admin |
Send your public key to the admin:
Copy the output and send it via email or chat.
Configure SSH¶
Copy-paste this into your terminal:
mkdir -p ~/.ssh && cat >> ~/.ssh/config << 'EOF'
Host hpc.tp-stack.co.uk
ProxyCommand cloudflared access ssh --hostname %h
IdentityFile ~/.ssh/tpstack
EOF
chmod 600 ~/.ssh/config
Done. You'll never need to do this again.
Connect to the Cluster¶
Once the admin confirms your SSH key is deployed:
First time per 24 hours:
- Your browser opens automatically.
- Enter your email address.
- Check your email for a 6-digit code.
- Enter the code.
- SSH connects.
After that, for the next 24 hours, ssh YOUR_USERNAME@hpc.tp-stack.co.uk just works — no browser, no codes.
You should see:
Verify everything works:
whoami # your username
id # your UID and groups
pwd # your home directory
sinfo # cluster partitions and nodes
Transfer Files¶
Upload to the cluster¶
scp myfile.csv YOUR_USERNAME@hpc.tp-stack.co.uk:~/
scp -r my-project/ YOUR_USERNAME@hpc.tp-stack.co.uk:~/
Download from the cluster¶
scp YOUR_USERNAME@hpc.tp-stack.co.uk:~/results/output.csv ./
scp YOUR_USERNAME@hpc.tp-stack.co.uk:~/results/*.png ./
Upload to shared project space¶
All transfers go through the encrypted tunnel automatically.