Table of Contents
Waldur User Guide
HPC Documentation:
Home • Registration • Connection • First Successful Job • Shared File System (Lustre) • Batch Job Execution (SLURM) • Resource Allocations and Project Requests
Waldur is the self-service portal used to manage HPC projects, resource allocations, user access, and usage accounting.
If you are a VU MIF user working within the default allocation, you may never need to use Waldur. However, project members and users with additional resource allocations will use Waldur to manage their HPC access.
What Can I Do in Waldur?
Waldur allows you to:
Create and manage your HPC account Manage SSH login keys View assigned HPC resources Check allocation limits View resource usage Join project workspaces Access project-specific HPC allocations
Logging In
Open:
Sign in using one of the supported authentication methods:
LITNET FEDI eduGAIN Local account (provided only when federated login is unavailable)
Figure 1. Waldur login page. Most Vilnius University users should authenticate using LITNET FEDI.
Most Vilnius University users should use LITNET FEDI.
External users usually use eduGAIN or credentials provided by the HPC administrators.
Complete Your Profile
After your first login, review your profile information.
Navigation:
Manage
Figure 2. Review and update your profile information.
Keeping your information up to date helps administrators provide support and manage project memberships.
Create an HPC Account
Before using HPC resources, create your HPC user account.
Navigation:
Dashboard → Select Workspace → HPC User Account
Figure 3. Creating an HPC account in Waldur. Account information is synchronized automatically to the HPC authentication system (FreeIPA).
After the account has been created, it can be used for:
SSH SCP SFTP WinSCP Visual Studio Code Remote SSH
Configure SSH Keys
SSH keys are required for HPC access.
Navigation:
Manage → SSH Keys → Add SSH Key
Figure 4. Upload and manage SSH public keys used to access the HPC cluster.
Paste your public key, for example:
ssh-ed25519 AAAAC3NzaC1…
You may upload multiple SSH keys, for example:
Work computer Laptop Personal workstation Using SSH keys is more secure and convenient than password-based authentication.
Select a Workspace
A user may belong to multiple organizations or projects.
Navigation:
Select Workspace
Figure 5. Workspace selection. Choose the organization or project whose resources you want to access.
Typical workspaces include:
MIF users VU users Research projects Collaborative projects
Understanding Projects
A project is a collection of users and allocated resources.
Projects are commonly used for:
Research groups Scientific collaborations Grant-funded projects Shared laboratory environments
Projects allow multiple users to share CPU and GPU resources under a common allocation.
View Available Resources
To view project resources:
Navigation:
Dashboard → Managed Projects → Project → Resources
Figure 6. Project resources page showing available HPC services and resource allocations.
This page displays information about:
CPU allocations GPU allocations Available services Resource limits
Find Your HPC Login Information
To view the credentials required for connecting to the HPC cluster:
Navigation:
Dashboard → Managed Projects → Resources → HPC Resource
Locate:
Login with
Figure 7. The “Login with” section contains the information required to access the HPC cluster.
This section typically contains:
HPC username Login instructions Authentication information
You should use:
The HPC user account created in Waldur The SSH key uploaded in the SSH Keys section
For connection instructions see:
Find Your SLURM Allocation
To find the allocation account required for job submission:
Navigation:
Dashboard → Managed Projects → Resources → HPC Resource
Locate:
Submit with
Figure 8. The “Submit with” section contains the SLURM allocation account that must be used when submitting jobs under a project allocation.
Look for an allocation name similar to:
alloc_2026_MY_PROJECT
Use this allocation in your SLURM job scripts:
#SBATCH –account=alloc_2026_MY_PROJECT Look for an allocation name beginning with: alloc_
You will need this value when submitting SLURM jobs under a project allocation.
Most VU MIF users do not need to specify the –account parameter because they use the default allocation.
Only users assigned to project resources should use the allocation account provided by Waldur.
View Allocation Limits
To see project quotas and allocation limits:
Navigation:
Dashboard → Managed Projects → Resources → HPC Resource
Locate:
Backend ID
Figure 9. Allocation limits and usage information. This section shows the resources assigned to the project.
Depending on the project configuration, you may see:
CPU allocations GPU allocations Resource quotas Usage information
For details about quotas and resource usage see:
Inviting Collaborators
Project administrators can add additional users to a project.
Typical workflow:
A user creates a Waldur account. The user uploads SSH keys. A project administrator adds the user to the project. The user gains access to project resources. The user can submit jobs using the project allocation.
Frequently Asked Questions
Do all HPC users need Waldur?
No.
Most VU MIF users can use the default HPC allocation without interacting with Waldur.
Waldur is primarily used for project-based resource management.
Where can I find my SLURM account?
Navigation:
Dashboard → Managed Projects → Resources → HPC Resource → Submit with
The allocation account typically begins with:
alloc_
Why can't I submit jobs using my allocation?
Verify that:
You are a member of the project.
The allocation exists.
The allocation name is correct.
You specified the correct –account parameter.
Can I upload multiple SSH keys?
Yes.
Multiple SSH keys can be uploaded and managed through the SSH Keys page.
Where can I see how many resources are available?
Navigation:
Dashboard → Managed Projects → Resources
Common Problems
No Resources Are Visible
Verify that:
You selected the correct workspace. You are a member of the correct project. The project has active allocations.
SSH Login Does Not Work
Verify that:
Your HPC account has been created. Your SSH public key has been uploaded. You are using the correct private key.
Invalid SLURM Account
Check the allocation shown in:
Dashboard → Managed Projects → Resources → HPC Resource → Submit with
The value used in SLURM must exactly match the allocation displayed by Waldur.
Next Steps
Once your account and allocations are configured:
Connection First Successful Job Batch Job Execution (SLURM) Resource Allocations and Project Requests This guide was prepared and updated by the VU MIF HPC team with the assistance of Microsoft Copilot. Screenshots may change as the Waldur interface evolves. Always refer to the current portal interface if menu names differ.









