= djAI installation and configuration
== Preparation
//dj//**AI** 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: [https://my.hidrive.com/lnk/u8nIg6fD#file 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.