Add comprehensive guide for managing Klone home directory space#2339
Draft
Add comprehensive guide for managing Klone home directory space#2339
Conversation
Co-authored-by: sr320 <4442039+sr320@users.noreply.github.com>
Copilot
AI
changed the title
[WIP] Klone home directory full
Add comprehensive guide for managing Klone home directory space
Oct 3, 2025
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
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.