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.

Installation Wizard

The Atlas Installation wizard has five steps: License, Requirements, Options, Installation, and Complete.

Step 1: License

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

Step 2: Requirements

Atlas Manager checks the rows Internet Connection, Atlas Manager Version, Docker, Memory, Disk Space, and Docker Disk Space. A met requirement shows a green check; an unmet one shows the reason below 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.
• 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.

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.

Step 5: Complete

Installation Complete 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 All containers running.
• Atlas Access shows the address of Atlas, with an HTTP and HTTPS choice, and a status line. Network Access means other devices on the practice network can connect; Local Access Only means the host computer has no local network connection, so Atlas is reachable only on this computer.

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 always shows the 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.

Next Step

A new installation holds no accounts, and Atlas Access shows "No accounts yet. 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 every patient record and image on the computer; the license and existing backups are kept. Members of the previous deployment are listed under Detached Members in Dermi Portal, as described in Inviting and Managing Team Members.

1. Download and install the current Atlas Manager release 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, leave Create Backup Before Uninstalling on unless the data is not needed, select Start Uninstallation, 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 Generate New License on the Overview page and enter the new key on the License step.