Add comprehensive guide for managing Klone home directory space #2339
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Problem
The Klone home directory has a strict 10GB storage limit that fills up quickly with cache directories from various applications. Users were experiencing full home directories with the main culprits being:
.cache(3.9G) - General application cache.local(2.5G) - User-installed packages and application data.apptainer(2.0G) - Apptainer/Singularity cache.vscode-server(1.3G) - VS Code Remote Server files.cursor-server(1.3G) - Cursor editor server filesThe question was whether these directories could be relocated to group storage (
/gscratch/srlab) and how to accomplish this.Solution
Created a comprehensive new documentation guide (
klone_Managing-Home-Directory.md) that provides detailed, actionable instructions for relocating cache directories to group storage. The guide includes:Key Features
Step-by-step relocation instructions for each cache directory using symbolic links:
.cache).vscode-server).cursor-server).apptainer) - using environment variables.local) - with appropriate warningsComplete automated setup script that safely:
rsyncto copy existing contentVerification and troubleshooting sections to ensure successful relocation
Maintenance guidance for ongoing space management
Example Usage
Users can now simply run the provided script:
Or follow step-by-step instructions to relocate individual directories as needed.
Documentation Updates
klone_Data-Storage-and-System-Organization.mdto reference the new guide in the home directory sectionklone_Conda.mdto point users experiencing space issues to the cache management guideImpact
This provides Roberts Lab members with a clear, safe method to reclaim home directory space by relocating cache directories to the 1TB group storage area, directly addressing the issue of home directory limits.
Original prompt
✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.