Getting Started

To get started first clone the Newton repository.

git clone https://github.com/blairisme/newton.git

Once the repository has been cloned the system can be started either via docker or via the command line. Docker does not require the installation of additional software of frameworks but does take time to set up and requires more disk space.

Via Docker

Ensure you have Docker and Docker-Compose installed and then run the following command.

gradlew systemStart

This will instruct Docker to download and install all the dependencies and software required by Newton. Once complete the Newton web app, data processing slave, integrated Jupyter Hub and database servers will be started. Once started the Newton user interface can be found here.

Via the Command Line

The Newton system can also be run locally. To do so issue the following commands to start the various system components.

To start the Newton web app with an in-memory database run the following.

gradlew appStart

To start the Newton data processing slave run the following in another terminal.

gradlew slaveStart

These commands will start the main Newton application and an accompanying data processing slave. These commands wont start the Jupyter Hub integration. Once started the Newton user interface can be found here.

Locations

Once started the Newton user interface can be found here.

http://localhost:9090
https://localhost:8443

Note

Browsing to https://localhost:8443 may show an insecure warning. This is because the certificate Newton uses is only valid for http://blairbutterworth.com, not localhost. It is safe to accept the security warning and proceed.

Depending on the in which the Newton system was started the following services might also be available.

[Database] http://localhost:3306
[Processor] http://localhost:8080
[Jupyter Hub] http://localhost:8000