Installation
Configuration Files
Once the Requirements information has been passed along to us, we’ll generate a couple of configuration files as part of your installation. Keep these as they will be needed during the install process.
- config.ini - this will store your database connection information, license, and any other customized info
- docker-compose.yml - this will store all your proper boot up procedures for ItemPath, including running the web server, API, and other services
- appdata.db - this is the initial internal database for ItemPath, such as root users, reports, and other data
- access.txt - this will temporarily give you the username and password needed to download ItemPath core files.
Installation Steps
The installation process for ItemPath can be broken down into a few simple steps.
- Confirm Docker 19 or greater is installed on the virtual machine by running “docker version” in the terminal. If Docker is not installed, instructions can be found here.
- Install Docker Compose 1.22 or greater. Installation instructions can be found here.
- Once Docker and Docker-compose have been installed, you’ll want to take the docker-compose.yml file that’s been provided to you and put that in the user directory (the user should be the same one provided during preinstallation).
- From the terminal, it’s time to download ItemPath. Navigate to the directory containing the docker-compose.yml file by typing “cd ~”. Then, download ItemPath using the command “docker-compose pull”. You’ll be prompted to enter a username and password, which has been provided in the access.txt file you received during preinstallation.
- From the terminal, run the following commands to create the local folder for ItemPath: mkdir -p ~/ItemPath/files and mkdir -p ~/ItemPath/data”
- After doing so, you’ll want to put both the config.ini and appdata.db files you received during preinstallation into the ~/ItemPath/data folder.