Skip to content

graphjs/graphjs-server

Repository files navigation

GraphJS-Server

An event-driven, non-blocking GraphJS Server.

Extends Pho REST Server APIs. For more information, check out http://graphjs.com

GraphJS-Server does not rely on a third party HTTP Server such as NGINX or Apache HTTPD. But it is recommended that you run it behind a proxy server for static assets and caching.

Requirements

Heroku Installation

Heroku is popular cloud provider by Salesforce. To install, just click the button below, and when asked, fill in the form with your email (you don't need to touch any other fields):

Deploy

WARNING for Heroku installations: Since GrapheneDB (the cloud Neo4J provider) provision takes longer than app's initial build and launch, you will need to wait at least 5 minutes before testing your instance after setup. If it still doesn't work, try rebooting the app after it's built for the first time. This is a common issue first-time Heroku installers are facing, please beware.

Once Heroku is deployed you can test it with the /whoami command with a GET request to https://{my_heroku_instance}.herokuapp.com/whoami

Feel free to watch this video at https://youtu.be/K7bWKlT0k_g for a preview of the process.

Manual Installation

In case, heroku installation is not an option for you, here are the steps to install it manually:

  1. The recommended way to install pho-server-rest is through git. MacOS and most UNIX operating system come with git equipped.

    git clone https://github.com/phonetworks/graphjs-server/

    If you are on Windows or don't have git preinstalled, you may download and install git from https://git-scm.com/, or just download the graphjs-server zip tarball from https://github.com/phonetworks/graphjs-server/archive/master.zip and extract.

  2. Install the PHP dependencies using Composer.

    composer install
    
  3. Create a copy .env.example file as .env file.

  4. Update the .env file.

    1. Set the Neo4j username and password of INDEX_URI. For example:

      bolt://neo4j_username:neo4j_password@localhost:7687
      
    2. Set values of FOUNDER_NICKNAME, FOUNDER_EMAIL, FOUNDER_PASSWORD.

    3. Set values of MAILGUN_KEY, MAILGUN_DOMAIN. (Optional)

License

MIT, see LICENSE.