Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Oct 3, 2025

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 files

The 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

  1. Step-by-step relocation instructions for each cache directory using symbolic links:

    • General cache (.cache)
    • VS Code Server (.vscode-server)
    • Cursor Server (.cursor-server)
    • Apptainer cache (.apptainer) - using environment variables
    • User-local packages (.local) - with appropriate warnings
  2. Complete automated setup script that safely:

    • Creates target directories in group storage
    • Uses rsync to copy existing content
    • Creates symbolic links to maintain application compatibility
    • Configures environment variables for Apptainer
  3. Verification and troubleshooting sections to ensure successful relocation

  4. Maintenance guidance for ongoing space management

Example Usage

Users can now simply run the provided script:

bash ~/setup_cache_relocation.sh
source ~/.bashrc

Or follow step-by-step instructions to relocate individual directories as needed.

Documentation Updates

  • Added new guide to the Klone Guides navigation menu
  • Updated klone_Data-Storage-and-System-Organization.md to reference the new guide in the home directory section
  • Updated klone_Conda.md to point users experiencing space issues to the cache management guide
  • All documentation builds successfully without errors

Impact

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

This section details on the original issue you should resolve

<issue_title>Klone home directory full</issue_title>
<issue_description>the main culprits are

1.3G    ./.cursor-server
1.3G    ./.vscode-server
2.0G    ./.apptainer
2.5G    ./.local
3.9G    ./.cache

tempted to delete cache ... but wondering if can have vscode-server and or all of these live at gscratch/srlab ?

and how might do this.

</issue_description>

Comments on the Issue (you are @copilot in this section)

Fixes #2338

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

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
Copilot AI requested a review from sr320 October 3, 2025 14:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Klone home directory full

2 participants