Troubleshooting Image Storage Issues

Images Not Loading or Showing Broken Thumbnails

Symptom: Images appear broken or fail to load in the Dermi Atlas Professional interface.

Solutions:

1. Refreshing the page reloads the images. Image links are refreshed automatically each time the page loads, which resolves images that fail to load after a period of inactivity.
2. Confirm the Object Storage Server container shows as running in the Container Status view of Dermi Atlas Manager. The storage service must be running for images to load.
3. If thumbnail generation was interrupted during upload, re-uploading the affected images regenerates the thumbnails.

Image Upload Fails

Symptom: Image uploads fail with a timeout or processing error.

Solutions:

1. If uploads repeatedly time out, use the Restart control in Dermi Atlas Manager, which restarts the Atlas system, including the Object Storage Server.
2. Verify that the host has sufficient free disk space. Insufficient disk space causes upload failures. The available space can be checked in Docker Desktop under Settings => Resources, or via Docker Engine on Linux deployments.
3. Supported image formats include JPEG, PNG, WebP, AVIF, GIF, and TIFF. Most images are stored in their original format. Formats that browsers cannot display reliably, such as TIFF, are automatically converted to a web-compatible format on upload.
4. Large images should be reduced in size before uploading to avoid processing timeouts.

Image Rotation Errors

Symptom: Image rotation fails or produces corrupted output.

Solutions:

1. JPEG images are rotated without loss of quality where possible.
2. Transient errors can be resolved by retrying the rotation operation.
3. If rotation consistently fails for a specific image, the file may be corrupted. Re-uploading the original image is recommended.

Storage Service Connection Error

Symptom: A connection error is reported when accessing the storage service.

Solutions:

1. Verify that the Object Storage Server container shows as running in the Container Status view of Dermi Atlas Manager.
2. Check Docker volumes for corruption. For container recovery steps, see Troubleshooting Docker Issues.
3. The Restart control in Dermi Atlas Manager restarts the whole Atlas system, including the Object Storage Server, rather than restarting a single storage service in isolation.