# app-ktor-server

This modules contains server application, responsible for handling all HTTP requests 
in both production and development environment. It is built as KTOR server.

# Development running:

2. Build and run server locally:

```
# Linux
$ ./gradlew app-ktor-server:run

#Windows
$ gradlew app-ktor-server:run
```

```
# 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
```

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](https://ktor.io/docs/configurations.html#command-line).

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.

* __Step 5: Add a learning space__:
```
./gradlew app-ktor-server:run --args='newlearningspace --url http://your.ip.address:8087/ --title learningspacetitle --adminpassword adminpassword'
```
to show learning space list add base url in com.ustadmobile.system.systemBaseUrl=your_url
in buildconfig.default.properties

See [INSTALL.md](../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
```

This will build the server distribution zip ( in ```build/distributions/ustad-server.zip``` ) which can
then be used as per the [INSTALL.md documentation](../INSTALL.md).