Manual installation requires following dependencies before continue to install
- DotNet Core 5.0 (https://dotnet.microsoft.com/download/dotnet/5.0)
- Redis (https://redis.io/download)
- Database Server (Postgres, Oracle, MS Sql Server is supported)
- BaseX Server (https://basex.org/download/)
Installation steps
1. Download the installation package
Download the zip page depending on your environment, Linux or Windows packages distributed separately.
2. Extract the zip package
Create installation directory with full permissions. Avoid using space or special characters in directory name. This directory will be referenced as <installdir> in next steps.
Extract the zip package to installation directory.
3. Update settings
Default configuration settings are stored in appsettings.json file. Emakin uses layered multiple JSON configuration files to override configuration settings and changing any default setting in <installdir>/appsettings.json file is not recommended.
Create a new file in <installdir>/Configuration directory with appsettings.json name and set updated configuration setting in this file.
Example <installdir>/Configuration/appsettings.json file to set database connection for host administration;
{
"DbConnStr": "Host=sqlserver;Database=EMAKIN;Username=emakin;Password=emakin;",
"ProxyUri" : ""
}
Configuration settings can be overridden in following order.
- <installdir>/appsettings.json
- <installdir>/Configuration/appsettings.json
- Environment Variables with "AK_" prefix
- Command line arguments
3. Check ports
By default emakin listens from 80, 5000 port numbers. If you have another application running on your server using same ports, you need to change port numbers from appsettings.json configuration file.