Images Not Loading or Showing Broken Thumbnails
Symptom: Images appear broken or fail to load in the Dermi Atlas Professional interface.
Solutions:
- Image links are signed with a limited lifetime. They are refreshed automatically when a page loads and periodically while a view stays open, and refreshing the page forces a fresh set. This resolves images that fail to load after a period of inactivity.
- 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.
- 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, a size limit error, or a processing error.
Solutions:
- If uploads repeatedly time out, use the Restart control in Dermi Atlas Manager, which restarts the Atlas system, including the Object Storage Server.
- 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.
- 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.
- A file above the per-file size limit is rejected in the browser before the upload starts, rather than timing out, and the error message states the limit that applies. Saving the image at a smaller file size and uploading it again resolves this.
- An image within the per-file size limit can still be rejected during server-side processing with "Image resolution exceeds the supported maximum of 100 megapixels." That limit applies to the pixel dimensions rather than the file size, so the image must be resized to smaller dimensions before uploading.
- Up to 50 images can be uploaded at once. A larger selection is rejected in full, so it should be split into smaller batches.
Image Rotation Errors
Symptom: Image rotation fails or produces corrupted output.
Solutions:
- JPEG images are rotated without loss of quality where possible.
- Transient errors can be resolved by retrying the rotation operation.
- 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:
- Verify that the Object Storage Server container shows as running in the Container Status view of Dermi Atlas Manager.
- Check Docker volumes for corruption. For container recovery steps, see Troubleshooting Docker Issues.
- 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.