Dermi Documentation
Installation, setup, and everyday use of Dermi Atlas Professional, Dermi Atlas Manager, Dermi Atlas Companion, and the Dermi Portal.
Getting Started
What Dermi Atlas is, a quick start, and finding your way around
Introduction to Dermi AtlasStart Here
What Dermi Atlas is, the role of each product in the family, how accounts and licensing work, and where to go next to set up a practice.
Quick Start Guide: From Sign-Up to the First Patient
The end-to-end path to a working Dermi Atlas installation, from the Dermi Cloud Services account and free trial to the first team account and the first patient.
Navigating Dermi Atlas
A tour of Dermi Atlas Professional after signing in. The sidebar, the Summary page, the open patient's pages, the Account page, and the Preferences page.
Installation
System requirements, Atlas Manager, deployment, and backups
System RequirementsStart Here
The computer, operating system, memory, disk, Docker, and network requirements for running Dermi Atlas Professional with Dermi Atlas Manager.
Browser Compatibility and PWA Support
Which browsers open Dermi Atlas Professional, how to install it as an app on computers, tablets, and phones, and how to get the best PDF exports in Safari.
Installing Dermi Atlas Manager
Download Dermi Atlas Manager from Dermi Portal, install it on Windows, macOS, or Linux, and activate the license key on first launch.
Installing Dermi Atlas Manager on Windows
Install Dermi Atlas Manager on Windows 10 or later and start it with administrator rights so it can open the Windows Firewall ports for Atlas.
Installing Dermi Atlas Manager on macOS
Install Dermi Atlas Manager on a Mac with Apple silicon running macOS 14 Sonoma or later, and open it for the first time.
Installing Dermi Atlas Manager on Linux
Install the Dermi Atlas Manager Debian package on Ubuntu, Debian, and distributions based on them, and resolve missing dependencies.
Installing Docker for Dermi Atlas Professional
Install Docker Desktop on Windows or macOS, or Docker Engine on Linux, and set it up so Dermi Atlas Professional starts with the computer.
Deploying Dermi Atlas Professional
Install Dermi Atlas Professional with the Dermi Atlas Manager installation wizard, check that it is running, and open it from other devices on the practice network.
Backing Up and Restoring Dermi Atlas Professional
Create, export, and delete backups on the Backup Management page of Dermi Atlas Manager, and restore Atlas on the same computer or on a new one.
Network and Access
Firewall rules, static IP addresses, and HTTPS certificates
Firewall Configuration for Dermi Atlas ProfessionalStart Here
The ports Dermi Atlas Professional uses on the host computer, what Dermi Atlas Manager configures on each operating system, and when a firewall needs a manual change.
Windows Firewall Configuration for Dermi Atlas Professional
Let Dermi Atlas Manager create the Windows Firewall rules for Dermi Atlas Professional, check them, and add rules manually when a policy prevents it.
macOS Firewall Configuration for Dermi Atlas Professional
Check the macOS firewall on the host computer so that devices on the practice network can reach Dermi Atlas Professional through Docker Desktop.
Linux Firewall Configuration for Dermi Atlas Professional
How the Linux firewall relates to the ports Docker Engine publishes for Dermi Atlas Professional, and how to confirm that practice devices can connect.
Configuring a Static IP Address for Dermi Atlas Professional
Give the Dermi Atlas Professional host computer a fixed IP address so that device bookmarks, installed apps, and the HTTPS certificate keep working.
SSL Certificate Setup for HTTPS Access
Download the Dermi Atlas Professional certificate from Dermi Atlas Manager, trust it on each device for HTTPS access, and replace it when the host address changes.
Installing SSL Certificates on Windows
Install the Dermi Atlas Professional certificate in the Windows Trusted Root Certification Authorities store for HTTPS access, and remove a previous one.
Installing SSL Certificates on macOS
Add the Dermi Atlas Professional certificate to Keychain Access on a Mac, set it to Always Trust for HTTPS access, and remove a previous one.
Installing SSL Certificates on iPhone and iPad
Install and trust the Dermi Atlas Professional certificate on iPhone and iPad for HTTPS access, with Dermi Atlas Companion or a transferred file.
Installing SSL Certificates on Android
Install the Dermi Atlas Professional certificate as a CA certificate on Android phones and tablets for HTTPS access, and remove a previous one.
Account Management
Account types, invitations, seats, and account security
Account Types and PermissionsStart Here
How the Dermi Cloud Services account relates to team member accounts, and what Clinician and Assistant accounts can each do in Dermi Atlas Professional.
Creating the First Account
Create the first account on a new installation of Dermi Atlas Professional. The owner invites their own address from the Dermi Portal, claims the invitation, and signs in.
Inviting and Managing Team Members from the Dermi Portal
The owner's guide to the Members section of a license card. Invite members, read member and sync status, change account types and addresses, and remove or reinstate members.
Claiming a Team Invitation
The member's guide. Claim an invitation on the practice network with the email address and claim code, link an existing account to a fresh invitation, and complete a change from the Dermi Portal.
Sharing Patient Records Across a Team
How the members of a Dermi Atlas Professional team share one set of patient records, how their activity is recorded, and what stays with the team when a member leaves.
Seats and Team Billing
What the Dermi Atlas Professional plan includes, how additional clinician and assistant seats are priced, where seats are purchased, and what happens when members exceed seats.
Account Security: Passwords, Two-Factor Authentication, and Devices
Secure a Dermi Atlas Professional team member account. Password requirements, two-factor authentication, password changes and recovery, signed-in devices, and security notifications.
Managing the Dermi Cloud Services Account
The settings of the Dermi Cloud Services account in the Dermi Portal. Profile, email address, password, two-factor authentication, signed-in devices, and account deletion.
Features
Patients, images, capture, comparisons, annotations, and exports
Managing PatientsStart Here
Create a patient record in Dermi Atlas, edit its details, tags, and assigned members on the Patient Details page, and delete a record.
Patient Search and Filtering
Find patients on the Dermi Atlas Patient Database page with search, sorting, and date, tag, member, and attribute filters, and read what each patient card shows.
Assigning Patients and Team Views
Assign patients to team members in Dermi Atlas, filter the Patient Database by member, and choose the list the Patient Database and the Summary page open on.
Clinical Entries and Appointment Notes
Create clinical entries in Dermi Atlas, set the appointment date, build the image workspace and comparisons, add notes and tags, and find or delete entries.
Uploading and Organizing Images
Upload photographs to a patient's Image Pool in Dermi Atlas, organize the pool by date, sort order, view, and tags, and use its images in entries and exports.
Capturing Photos with Atlas Companion
Install Dermi Atlas Companion on iPhone or iPad, connect it to the practice's Atlas, and capture follow-up photos framed against an earlier photograph of the patient.
Viewing Images
Open a photograph in the Dermi Atlas Image Viewer, set the rendering quality, and edit, rotate, download, or delete it from the Image Properties drawer.
Tag Management
Build and maintain a tag library in Dermi Atlas, with color-coded categories, tag assignment across patients, entries, and images, inheritance, and CSV import and export.
Organizing Images with Zones
Group a visit's photographs into body-area zones in Dermi Atlas, review a zone's overview and dermoscopy together, follow a dermoscopy series across visit dates, and dissolve a zone.
Documenting Full Body Photography Sessions
Capture a full body photography session in Dermi Atlas against a standard pose set, record skipped poses, review each pose, compare sessions, and export or delete a session.
Documenting Lesions
Create lesion records on overview photographs in Dermi Atlas, link a lesion's marks and dermoscopy across visits, record its details, and delete a record.
Comparing Images in Split and Overlay Views
How to build a comparison group from a clinical entry in Dermi Atlas and compare visits in the split layouts and the overlay layer stack, with manual adjustment, undo, and export.
Automatic Alignment for Image Comparisons
How Auto Align in Dermi Atlas matches the same anatomy across the photographs in a comparison so the images line up, and what happens when an image cannot be aligned.
Reading Photographs with Image Filters
How to read redness, pigmentation, and texture in Dermi Atlas under reversible image filters, with one filter across every image on the canvas and the stored photograph unchanged.
Annotating Clinical Images
How to draw, edit, hide, and share markup on clinical photographs in Dermi Atlas, point with Live Pointer during a consultation, and carry marks into comparisons and exports.
Real-Time Synchronization Across Devices
How edits in Dermi Atlas save as they are made and appear on every device and colleague holding the same record, and how presence shows who else is working there.
Clinical Image Consent
Set the consent enforcement level in Dermi Atlas, record a patient's consent for clinical photography by digital signature or external verification, and revoke it.
Exporting Images with Custom Export
Compose clinical photographs and comparisons into finished images in Dermi Atlas, with framing presets, themes, date labels, practice branding, and a declared export purpose.
Generating PDF Reports
Generate PDF reports from patient records in Dermi Atlas, covering a clinical entry, patient details, the Image Pool, full body photography, or the complete record.
Recovering Deleted Records
Restore a deleted patient from Deleted Records, or a deleted entry, image, zone, full body session, or lesion from the patient's Deleted Items drawer in Dermi Atlas.
Configuring Data Retention for Deleted Records
Choose what happens to deleted records in Dermi Atlas Professional and how long they stay recoverable, with the deletion and retention settings in Atlas Manager.
Security and Compliance
Data protection, audit logging, compliance guides, and administration
Security and Compliance FundamentalsStart Here
How the on-premises deployment and security features of Dermi Atlas Professional support a practice's obligations under HIPAA, PIPEDA, and the Australian Privacy Act.
Data Security Architecture
The security controls of Dermi Atlas Professional, the complete list of data sent to Dermi, and the safeguards the practice configures on the host computer.
Audit Logging Configuration
Set the audit logging level of Dermi Atlas Professional, understand what each entry records, and read a member's, a patient's, or the deployment's activity.
HIPAA Compliance Guide
How Dermi Atlas Professional features map to the HIPAA Security Rule safeguards and the breach assessment, and what the practice configures itself.
PIPEDA Compliance Guide
How Dermi Atlas Professional features map to the PIPEDA fair information principles and support provincial health privacy obligations in Canada, including PHIPA and HIA.
Australian Privacy Act Compliance Guide
Learn how Dermi Atlas Professional features map to the Australian Privacy Principles to support the privacy obligations of practices handling health information.
Atlas Manager Administration
The admin passphrase, the Administration area of Dermi Atlas Manager, the local account controls, the deployment-wide settings, and the deployment purge.
Troubleshooting
Fixes for installation, network, account, and backup issues
Troubleshooting Dermi AtlasStart Here
Find the troubleshooting article for a symptom in Dermi Atlas Manager or Dermi Atlas Professional, and send diagnostics to Dermi support from Atlas Manager.
Troubleshooting Dermi Atlas Manager Installation Issues
Resolve Dermi Atlas Manager installation problems, including blocked installers, Linux package errors, start-up error screens, refused license keys, and a lost admin passphrase.
Troubleshooting System Update Issues
Resolve Atlas update problems in Dermi Atlas Manager by the message shown, including a missing update, a failed backup check, a return to the installed version, and an unfinished update.
Troubleshooting Network and Connectivity Issues
Resolve connection problems with Dermi Atlas Professional, including other devices unable to open Atlas, a host computer on local access only, and an address that stops working.
Troubleshooting Account and Authentication Issues
Resolve sign-in problems in Dermi Atlas Professional, including refused sign-ins, restricted accounts, refused invitation claims, expired links, two-factor codes, and ended sessions.
Troubleshooting SSL Certificate Issues
Resolve SSL certificate problems with Dermi Atlas Professional, including browser warnings, a certificate that stops working after an address change, and an expired certificate.
Troubleshooting Docker and System Requirements
Resolve Docker problems for Dermi Atlas Professional, including Docker not detected or not starting, unmet memory and disk space requirements, and unsupported Windows on ARM computers.
Troubleshooting Atlas Installation and Start Issues
Resolve failures when Dermi Atlas Manager installs or starts Atlas, including download errors, a failed first start, errors on the Container Status card, and an interrupted operation.
Troubleshooting Licensing and Subscription Issues
Resolve license and subscription problems with Dermi Atlas Professional, including an expired subscription, the license limit, seat limits, offline license checks, and license moves.
Troubleshooting Real-Time Sync Issues
Resolve save and sync problems in Dermi Atlas Professional, including changes that could not be saved, edits from another session, offline status, and Safari connection blocks.
Troubleshooting Backup and Restore Issues
Resolve backup and restore problems in Dermi Atlas Manager, including refused and failed backups, restore failures, an unfinished restore, and Service Recovery at launch.
Troubleshooting Image Storage Issues
Resolve image problems in Dermi Atlas Professional, including images that do not load, refused or failed uploads, upload limits, and rotation errors.
Troubleshooting Email Delivery Issues
Resolve email delivery problems with Dermi Atlas Professional, including addresses blocked after bounces or spam complaints, on-premises delivery, rate limits, and unverified addresses.
Troubleshooting Performance Issues
Resolve slow page loads, slow image alignment, and slow image uploads in Dermi Atlas Professional by checking the host computer and the practice network.
Have a question not covered here?
Contact support with any question about a deployment or workflow. Typical response within 24 hours.