Installing Dermi Atlas Manager on Linux

System Requirements

• Compatible distributions (64-bit): Ubuntu 22.04+, Debian 12+, Linux Mint 21+, Pop!_OS 22.04+
• x64 (amd64) processor
• Administrator (sudo) privileges

These distributions share a minimum glibc version of 2.35. Other Debian-based distributions meeting this requirement may also be compatible but have not been tested.

Prerequisites

Before installing the .deb package, update the system package index to ensure dependency resolution succeeds.

sudo apt update

Installing the .deb Package

1. Download the .deb installer from the Dermi Portal Overview tab. The file is named in the format dermi-atlas-manager-{version}-linux-x64.deb.
2. Open a terminal and navigate to the download directory.
3. Install the package:

sudo dpkg -i dermi-atlas-manager-*-linux-x64.deb

1. If dependency errors are reported, resolve them:

sudo apt install --fix-broken -y

This command downloads and installs any missing runtime libraries (such as libwebkit2gtk-4.1-0) required by the application. On a fresh system, this step is typically required.

1. Launch the application:

dermi-atlas-manager

The application can also be launched from the desktop applications menu.

Uninstalling

To remove Dermi Atlas Manager:

sudo apt remove dermi-atlas-manager

To also remove configuration files:

sudo apt purge dermi-atlas-manager

Firewall Configuration

If your system uses UFW (Uncomplicated Firewall), allow the following ports:

sudo ufw allow 15015/tcp
sudo ufw allow 15045/tcp
sudo ufw allow 15815/tcp
sudo ufw allow 15845/tcp

Note: Actual ports may differ if conflict resolution occurred. Check Dermi Atlas Manager for the specific ports in use.

Troubleshooting

Dependency Errors During Installation

Symptom: dpkg reports unmet dependencies when installing the .deb package.

Solution:

sudo apt install --fix-broken -y

If packages are unavailable, run sudo apt update first, then retry the installation.

Missing Runtime Libraries

Symptom: Application fails to launch with an error referencing libwebkit2gtk-4.1 or a similar shared library.

Solution:

sudo apt install -y libwebkit2gtk-4.1-0

Note: This library is normally installed automatically as a dependency.

Permission Denied During Installation

Symptom: dpkg -i fails with a permission error.

Solution: The command must be run with sudo. If the current user does not have sudo privileges, an administrator account is required.

For additional troubleshooting, see Troubleshooting Dermi Atlas Manager Installation Issues.