frappe / frappe/press

[Enhancement]: Improve Error Messages for Storage-Related Failures with Actionable Solutions

Open
#4,971 0 comments 0 reactions 0 assignees View on GitHub
enhancement
Dominant language
Python
Stars
562
Forks
410
Avg merge
22h 15m
Merged PRs (30d)
197

Description

### Affected Area

Notifications/Alerts

### Problem Statement

The current error messages for storage issues only tell users what went wrong (e.g., "no space left on device") but don't provide instructions on how to fix it. Users are left without guidance on how to resolve the issue.
Current behavior:

Error shows: "Cannot complete backup: no space left on device"
User doesn't know what to do next
No cleanup suggestions or upgrade options provided

Expected behavior:

Error message includes actionable solutions
Links to relevant documentation
Alternative options like purging binlogs, clearing Docker images, or upgrading storage
Clear next steps for the user

ref: [](https://support.frappe.io/helpdesk/tickets/51041?view=VIEW-HD+Ticket-778)

### Proposed Solution

1. Display Error Banner on Top of Page
When storage errors occur, show a banner with:

- Clear error explanation
- Quick action buttons (Upgrade Storage, View Cleanup Guide)
- Dismissible option

2. Add "Click Here" Links in Error Messages
Modify error messages to include direct links:

- Link to storage upgrade page
- Link to cleanup documentation
- Link to relevant help articles

3. Provide Multiple Solutions in Error
Primary: Upgrade storage [link]
Alternatives:
- Purge old binlogs (command provided)
- Clear Docker images (command provided)
- Remove old backups (path provided)

Contributor guide

No contributing guide indexed for this repository

Research direction

Start by locating the storage-related failure messages and the Notifications/Alerts area described in the issue. Review how storage upgrades, cleanup guidance, binlog purging, Docker image cleanup, and old-backup removal can be linked or presented. Done means the agreed error flow provides clear next steps, relevant links, alternatives, and a dismissible banner where required.

Written by the indexing model from the issue text.

Assessment

Tech stack
docker, python
Domain
cloud, devops
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
30/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.