Deploying Dermi Atlas Professional

Before Starting

• Dermi Atlas Manager is installed and open; see Installing Dermi Atlas Manager.
• Docker is installed; see Installing Docker for Dermi Atlas Professional.
• The host computer is connected to the internet.
• On Windows, Atlas Manager was started with Run as administrator, so that it can open the Windows Firewall ports; see Installing Dermi Atlas Manager on Windows.
• On Windows, the practice network is set to Private in the Windows network settings, unless it is a domain network; see Windows Firewall Configuration for Dermi Atlas Professional.

Installation Wizard

The Atlas Installation wizard runs in five steps.

Step 1: License

Enter the license key, accept the End User License Agreement, and select Activate License. Once the license is active, the wizard moves to the next step.

Step 2: Requirements

Atlas Manager checks the rows Internet Connection, Atlas Manager, Docker, Memory, Disk Space, and Docker Disk Space. A met requirement shows a green check and the measured value; an unmet one shows the reason in its row. The minimums are listed in System Requirements.

• Docker Desktop installed but not running: select Start Docker Desktop.
• Docker not found: install Docker, then select Refresh, the icon at the top right of the list.
• Atlas Manager Update Required: update Atlas Manager with the action in that box, then continue.

When every row passes, select Continue.

Step 3: Options

Choose the installation type:

• Fresh Installation: installs the current release of Dermi Atlas Professional with no data.
• Restore Backup: installs Atlas from a backup, either one listed under Available Backups or an exported backup file chosen with Browse. The Atlas version the backup was made with is installed. See Backing Up and Restoring Dermi Atlas Professional.

Select the checkbox to accept the End User License Agreement, then select Start Installation, or Start Restore for a restore.

Step 4: Installation

Atlas Manager downloads, installs, and starts Atlas, and the progress bar names each stage. Keep Atlas Manager open and the computer on until the step finishes; the time depends on the internet connection. A restore can be stopped with Cancel until it begins replacing data. When the step fails, Support offers Send Diagnostics for Dermi support (Open Logs Folder while the computer is offline), and Retry returns to the Requirements step to run the installation again.

Step 5: Complete

Atlas installed (or Atlas restored) appears. Select Continue. A first installation opens the Admin Passphrase page before the Atlas Status page; see Atlas Manager Administration.

Checking the Deployment

The Atlas Status page shows the state of the installation:

• Atlas Control reads Running.
• Container Status reads Running.
• Atlas Access shows the address of Atlas, with an HTTP and HTTPS choice, and a status line.

On the status line, Local Network means other devices on the practice network can connect, and This Computer Only means the host computer has no local network connection, so Atlas is reachable only on this computer. On Windows, Public Network Profile means other devices cannot connect, and Firewall Rules Missing means they cannot unless rules were added manually; see Windows Firewall Configuration for Dermi Atlas Professional.

Select Open Atlas to open the sign-in page in a browser on the host computer. The default addresses are:

HTTP:  http://<host-ip>:15015
HTTPS: https://<host-ip>:15045

Atlas Access shows the HTTP and HTTPS ports in use, which differ from the defaults when a default port was busy.

HTTP works without setup and is unencrypted; HTTPS is recommended wherever the network includes Wi-Fi or is shared. Connections on the HTTPS address are encrypted with TLS 1.2 or TLS 1.3 and need the Atlas certificate trusted on each device; see SSL Certificate Setup for HTTPS Access.

Opening Atlas from Another Device

1. Connect the device to the same practice network as the host computer.
2. Enter the HTTP address shown on Atlas Access in the device's browser.
3. The Atlas sign-in page opens.

If it does not open, see Firewall Configuration for Dermi Atlas Professional and Troubleshooting Network and Connectivity Issues.

Inviting the First Member

A new installation holds no accounts, and Atlas Access shows "Invite the first member from the Dermi Portal." The license owner invites the first member from Dermi Portal, and the note clears at the installation's next check-in, or at once with Sync Now on the User Accounts card under Administration. The member then claims the invitation on the practice network; see Creating the First Account.

Starting Over with a Fresh Installation

A deployment is started over on the same computer by uninstalling Atlas and running the wizard again. Uninstalling removes Atlas, its configuration, and the patient records and images held in Atlas, and releases the license from this computer; the backup folder is kept with its backups and safety copies, so patient records remain on the computer until those are deleted. Members of the previous deployment are listed under Detached Members in Dermi Portal, as described in Inviting and Managing Team Members.

1. Update Atlas Manager to the current release: on Windows and macOS with Download Update, then Restart and Install, on the Atlas Status page, on Linux from the Downloads page in Dermi Portal.
2. Open Atlas Manager. If the Admin Passphrase page opens, set the passphrase and save the recovery phrase.
3. Open Administration and, under Purge and Uninstall, select Begin Uninstall on the Atlas Uninstall card. Confirm with the admin passphrase.
4. In the uninstall wizard, select Continue on the Requirements step, leave Create Backup on unless the data is not needed, select Start Uninstall, and select Done once it finishes.
5. In the installation wizard that opens, enter the same license key on the License step, accept the End User License Agreement, and select Activate License. The uninstall released the key.
6. On the Options step, select Fresh Installation, accept the agreement, and select Start Installation.
7. The license owner invites the members again from Dermi Portal, and each member claims the invitation on the practice network.

If Activate License reports that the key is in use on another deployment, the key could not be released during the uninstall. In Dermi Portal, select Manage License on the license card, then Revoke License, and confirm; then select Create License on the Overview page and enter the new key on the License step.