This modules contains server application, responsible for handling all HTTP requests in both production and development environment. It is built as KTOR server.
- Build and run using the runserver.sh script:
# Linux
$ ./runserver.sh --siteUrl http://your.ip.address:8087/
#Windows
$ runserver.bat --siteUrl http://your.ip.address:8087/
Where your.ip.address is your IP address or a domain/host URL that points to your system.
You may set the siteUrl in the configuration file instead of specifying this on the command line. Copy the default config file:
# Linux
cd app-ktor-server
cp src/main/resources/application.conf ./ustad-server.conf
# Windows
cd app-ktor-server
copy src\main\resources\application.conf .\ustad-server.conf
Then modify ustad-server.conf to set the siteUrl or other options.
Run ./runserver.sh --help to see options
You can also run the server by using the Java command directly:
cd app-ktor-server
java -jar build/libs/ustad-server-all.jar -config=my-application.conf
The port can be set using the command line as per KTOR server standard options, see ktor.io reference.
The application can be debugged using the same as any other standalone JAR using JWDP. In Android Studio or IntelliJ, Go to run, debug, configurations and then add a "remote" configuration.
See INSTALL.md for recommendations on production configuration.
#Production build
By default the Javascript (app-react) version will not be built and bundled in the static resources directory (because this will slow down development including building jvm tests etc). When building the server for production, use -Pktor bundleproductionjs to include the app-react web app as a static resource.
Linux:
$ ./gradlew app-ktor-server:distZip -Pktorbundleproductionjs=true
Windows:
$ gradlew app-ktor-server:distZip -Pktorbundleproductionjs=true