Developer Docs

SpringBot Server Setup

Before Starting

Before starting, please ensure that you have followed the Ubuntu 18.04 Virtual Machine Setup to setup a local instance of Ubuntu 18.04.

It is recommended to connect to your server via a telnet tool like PuTTY. If you used the details from the Ubuntu setup, then you should be able to connect via user@, with the password of cb. If you have never done this before, you can follow the Connect to your server to connect to your server.

Server Setup

The Ubuntu 18.04 Virtual Machine Setup for the local version Ubuntu 18.04 will need to completed to run your Codebots application.

Libraries & Tools

Java (v11)

OpenJDK 11.

To install JDK 11 on Ubuntu 18.04 copy and paste the following into the command prompt and press enter.

  1. Using PuTTY, you can Copy from Windows, then right click into the PuTTY window to paste the text.

    sudo add-apt-repository ppa:openjdk-r/ppa \
    && sudo apt-get update -q \
    && sudo apt install -y openjdk-11-jdk

    Depending on your internet speed, this will take a while as packages are downloaded and installed. When the process is finished you should see something like this:

  2. Update the Java certificates. Copy and paste the below a line at a time:

    sudo su
    /usr/bin/printf '\xfe\xed\xfe\xed\x00\x00\x00\x02\x00\x00\x00\x00\xe2\x68\x6e\x45\xfb\x43\xdf\xa4\xd9\x92\xdd\x41\xce\xb6\xb2\x1c\x63\x30\xd7\x92' > /etc/ssl/certs/java/cacerts
  3. Re-add all the CA certs into the previously empty file (copy and paste):

    /var/lib/dpkg/info/ca-certificates-java.postinst configure


Ubuntu 18.04 currently comes with NodeJS 8.10.0 by default. SpringBot has currently been tested with the combination of NodeJS 8.10 and AngularCLI 7.3.1.

  1. Install Node.js from the repositories, copy and paste:

    sudo apt install nodejs
    sudo apt install npm


Angular CLI

Install the version angular CLI that currently supports NodeJS v8.10.0.

  1. Copy and paste:

    sudo npm install -g @angular/cli@7.3.1
  2. After this has finished, running ng version should provide the following output:



SpringBot is primarily built around using the PostgreSQL database, though it can use others. To run a SpringBot application, you must have a database setup.

To setup the database for SpringBot, you will need a database and a user with the necessary permissions to create and drop tables.

  1. On Ubuntu 18.04 you can achieve this with the following (copy and paste):

    yes | sudo apt-get install postgresql postgresql-client-common


To install Gradle, copy and paste each one of these steps:

  1. Install zip first

    sudo apt-get install zip
  2. Install sdkman

    curl -s "" | bash

    If this is successfully installed you should see:

  3. Add sdk to the path

    source "$HOME/.sdkman/bin/"
  4. Install gradle 5.2.1

    sdk install gradle 5.2.1

    When this is complete you should see:


This completes the server setup required to run your SpringBot application! You can now SpringBot Development Environment: Source Code to start editing your SpringBot application, then Running SpringBot on your SpringBot server!