djAI installation and configuration

Preparation

djAI is easy to install and use. The software consists of two components:

• A web service providing an API with various functions. The web service runs on Windows and Linux machines with .net 7 Core.
• A client connecting with the web service. The client runs on Windows with .net 7.

For single-user application of the FREE personal / test / development edition, the web service is typically started on the same machine as the client. However, it is technically possible to run the service on a separate server machine even for the FREE edition, and you are allowed to do so, as long as you obey the other usage limitations of the FREE license.

In multi-user applications (for which you must buy a license in any case, even if they are non-commercial), running the service on a server machine is the common case, and you have the choice between Windows and Linux servers running .net 7 Core.

• Download the software to a temporary folder from here: ​djAI service and client download
• Unzip the zip package.
• Move the folder djAI to the server machine.
• Move the folder djAIClient to the client machine.

djAI web service installation

Installing the web service on the same machine as the Windows client

• Install .net 7 Core.
• Move the folder djAI to Documents or another suitable folder where you have write permission.
• The service runs, by default, on port 5000. If you want to change the port, edit the file djAI\run_djAI.cmd and change the port accordingly. Do not change the IP address in local installations:

  dotnet djAI.dll --urls http://127.0.0.1:5000
  

Installing the web service on a server

• Install .net 7 Core.
• Move the folder djAI to a suitable folder.
• Edit the file run_djAI.cmd in the djAI folder and change the loopback IP 127.0.0.1 to the IP address you want the service to listen to. You can also change the port, if required:

  dotnet djAI.dll --urls http://127.0.0.1:5000
  

• Configure the service to start on system reboot:
  • Linux: Run crontab -e and add the following line:

    @reboot /path/to/djAI/run_djAI.cmd
    

  • Windows: Use Scheduled tasks to configure automatic start.