Quick Start Guide: Set Up Dermi Atlas in 30 to 45 Minutes

Overview

This guide walks through the complete setup process for Dermi Atlas Professional, from creating a Dermi Cloud Services account to documenting the first patient. By the end of this guide, a fully functional clinical imaging system will be running on the local network.

Estimated time: 30 to 45 minutes (depending on internet speed and familiarity with the process)

Prerequisites

Before beginning, ensure the following are available:

• A computer running Windows 10/11 (64-bit), macOS 14 (Sonoma) or later on Apple Silicon (Intel Macs are not supported), or Ubuntu 22.04+, Debian 12+ (64-bit)
• At least 4GB of RAM (8GB or more recommended)
• At least 20GB of available storage
• Administrator privileges on the computer
• A stable internet connection
• An email address for account registration

Step 1: Create a Dermi Cloud Services Account

Dermi Portal is where the subscription and licenses are managed and the Cloud Demo is accessed.

1. Navigate to portal.dermi.ai in a web browser.
2. Select Sign up to open the registration page.
3. Enter the email address to be used for the Dermi Cloud Services account.
4. Select the Terms of Service and Privacy Policy checkboxes below the email field. The Continue button stays enabled while either box is clear, and submitting without both is refused with "Please accept all legal agreements to continue".
5. Select Continue.
6. Check the inbox for an email from notification@dermi.ai. If it does not appear, check the spam folder.
7. Click the link in the email to continue setup. Note that this link expires in one hour.
8. On the account setup page, enter a username (2 to 16 characters, using lowercase letters, digits, and underscores only), a first name or nickname (letters only, up to 64 characters), and a password. These can be changed later if needed.
9. Submit the form to complete account creation.

A Dermi Cloud Services account is now available.

Step 2: Start a Free Trial

1. Sign in to portal.dermi.ai with the new credentials.
2. The Overview tab loads, displaying the subscription status and license information.
3. Click Start Free Trial.
4. A redirect to Stripe follows for entering payment details. The card will not be charged during the 30-day trial period.
5. Complete the Stripe setup and return to Dermi Portal.
6. The trial is now active. The Overview tab displays the current plan details and license usage (0/1 active licenses).

Step 3: Generate a License Key

1. In the Overview tab, scroll down to the license section.
2. Click Generate New License.
3. A 20-character alphanumeric license key will be generated (for example, 422G L6NP 2BLF AK7L 9X5J).
4. Use the visibility toggle to view the key and the copy button to copy it to the clipboard.

Keep this key available for the Dermi Atlas Manager setup process.

Step 4: Download and Install Dermi Atlas Manager

Dermi Atlas Manager is the desktop application used to deploy and manage Dermi Atlas Professional.

1. In the Overview tab on Dermi Portal, locate the Dermi Atlas Manager download section.
2. Download the appropriate installer for the operating system.
3. Run the installer and follow the prompts to install Dermi Atlas Manager.

For detailed installation instructions specific to the operating system, see Installing Dermi Atlas Manager.

Step 5: Install and Configure Docker

Dermi Atlas Professional runs inside Docker containers, and Docker 28.0.0 or later is required. If Docker is not already installed, install it now.

For Windows and macOS:
Download and install Docker Desktop from docker.com.

For Linux:
Install Docker Engine from the distribution's package repository. See Installing Dermi Atlas Manager on Linux for the Ubuntu and Debian steps.

Configuration Checklist:

• Enable Start Docker Desktop when you sign in to your computer in Docker Settings => General.
• Confirm the computer has at least 4GB of system RAM, with 8GB or more recommended. The requirement check measures total system RAM rather than the memory allocated to Docker Desktop.
• Set Disk Usage Limit to at least 20GB in Docker Settings => Resources, with 100GB or more recommended so that images, volumes, and stored photographs have room to grow.

For detailed instructions on installing and configuring Docker, see Installing Docker for Dermi Atlas Professional.

Step 6: Complete Dermi Atlas Manager Setup

1. Launch Dermi Atlas Manager. It will perform an automatic initial setup.
2. On the License step, enter the license key generated in Step 3. Dermi Atlas Manager validates the key before continuing.
3. On the Requirements step, Dermi Atlas Manager checks the system dependencies, including Docker 28.0.0 or later.
4. On the Options step, select Fresh Installation, accept the End User License Agreement, and click Start Installation.
5. Wait for the installation to complete. A fresh installation typically takes under 10 minutes.

Important: Do not close Dermi Atlas Manager or restart the computer during installation.

Step 7: Access Dermi Atlas Professional

Once installation is complete, Dermi Atlas Manager will display the Atlas Status page.

1. Locate the Atlas Access section.
2. Click Open App or enter the displayed HTTP address (e.g., http://192.168.1.100:15015) in any browser on the local network.

If the application cannot be accessed from other devices on the network, the firewall settings may need to be checked. See Configuring Your Firewall for Dermi Atlas Professional for assistance.

Step 8: Create a First Local Account

Dermi Atlas Professional uses local accounts that are separate from the Dermi Cloud Services account.

1. Open Dermi Atlas Professional in a browser.
2. Select Sign up.
3. Enter an email address and select the End User License Agreement acknowledgment checkbox below it.
4. Complete verification by clicking the link sent to the email (recommended) or by using the verification link available inside Dermi Atlas Manager (shield icon).
5. Set a username (2 to 16 characters, using lowercase letters, digits, and underscores only), a first name or nickname (letters only, up to 64 characters), and a password to finish setup.

For more details on account types and creation, see Creating Your First Dermi Atlas Professional Account.

Step 9: Configure HTTPS (Optional)

Configuring HTTPS for secure, encrypted connections is recommended.

1. In Dermi Atlas Manager, navigate to the SSL Certificate section.
2. Click Download to save the certificate file.
3. Install this certificate on every device (phones, tablets, laptops) that will access Dermi Atlas Professional.

For instructions on installing certificates on specific devices, see SSL Certificate Setup for HTTPS Access.

Next Steps

The Dermi Atlas Professional deployment is now ready for use.

• Create a first patient record and upload clinical photographs.
• Review System Requirements to ensure long-term stability.
• Configure system settings in Dermi Atlas Manager, including activity logging levels.