Links

Installing PlexTrac

For Debian based operating systems (e.g. Ubuntu): If using a Red Hat based OS, such as RHEL or Centos, please contact PlexTrac Support for instructions to proceed.

Prerequisites

  • Machine/instance with minimum quad-core processor, 16 GB of memory, 250 GB of storage, and connection to the internet
  • CMD access to PlexTrac server
  • If using Let’s Encrypt: Ensure ports 443 and 80 are open in/outbound to allow a new certificate to be obtained when the docker containers are started
  • If using a custom domain, the DNS A record must be created
Delay any hardening procedures until after installation.

Installing Steps

Step 1: Log in to the server that will host PlexTrac.
Step 2: As a root user (or user with root privileges), run the following commands to download the PlexTrac utility from our public Github repository:
curl -Ls -o /tmp/plextrac https://github.com/PlexTrac/plextrac-manager-util/releases/latest/download/plextrac && sudo chmod a+x /tmp/plextrac && sudo bash /tmp/plextrac initialize -v
The command will also initialize the script, which will then begin to perform system updates. Once complete, the shell should be returned.
Step 3: Switch user to "plextrac".
sudo su - plextrac
Step 4: Run plextrac configure. A message “Error: Docker Hub key not found…” will appear at the end of the log, but this can be safely ignored the key will be added in the following steps.
plextrac configure
Step 5: Edit the .env file.
nano .env
Step 6: Find the following variables in the .env and make the changes listed in the table.
Variable
Action
Example
ADMIN_EMAIL=
Add a valid email address to create the initial user in the platform.
DOCKER_HUB_KEY=
Add the docker token provided by PlexTrac Support.
DOCKER_HUB_KEY=key123
CLIENT_DOMAIN_NAME=
If using a self-signed certificate, enter the IP address of the server. Otherwise, if a DNS A record was created, enter the DNS name here.
CLIENT_DOMAIN_NAME=plextrac.example.com
LETS_ENCRYPT_EMAIL=
If using Let's Encrypt, enter email to be are notified when the certificate is about to expire.
USE_CUSTOM_CERT=
If using a custom SSL certificate, set to true and follow step 7.
USE_CUSTOM_CERT=true/false
Step 7: If using a custom logo, favicon or SSL certificate, follow the instructions found here and here before continuing with Step 8.
Step 8: Run plextrac install.
plextrac install -y -v
Once complete, a summary page should be printed (example below).
Step 9: Login to the platform by navigating to the DNS or IP address that was set previously. The username will be the email specified during Step 6, and the password was provided with the docker token.
Change password immediately upon login.
© 2022 PlexTrac, Inc. All rights reserved.