How do I build and run dbKoda from source?

We recommend you use one of our installers if you can.  However, you can install and run dbKoda from source if you want to.   These instructions are for linux or mac systems.  Also see the instructions in the README.md file of https://github.com/SouthbankSoftware/dbkoda for more details instructions and various advanced ways you can run, build and configure the product. 

You should make sure you have nodeJs version 7.0 installed.  Also install yarn:

npm -g install yarn webpack-dev-server rimraf webpack

You need to clone 3 github repositories:

git clone https://github.com/SouthbankSoftware/dbKoda
git clone https://github.com/SouthbankSoftware/dbKoda-ui
git clone https://github.com/SouthbankSoftware/dbKoda-controller

Build in each of these directories:

for dir in dbKoda-ui dbKoda-controller dbKoda ;do
   ( cd $dir;yarn install  )
done

Startup the three main processes:

(cd  dbKoda-ui;yarn dev) & 
(cd  dbKoda-controller; npm run dev) & 
(cd  dbKoda; npm run byo) & 

Walla!  Your dbKoda should now be running.

These commands can be found in runfromsource.sh in the root directory of the dbKoda directory. 

Warning:   When you run dbKoda from source the dbkoda-controller listens on port 3030 for commands.  It's possible that an external program could communicate with the controller and send commands to your mongo databases.  This issue does not exist in the binary builds. 

OS Specific notes:

On Linux, you may need to install c++ :  yum install gcc-c++ for instance.  Also, you could try "npm rebuild" in the dbKoda-controller repository if you have errors invoking the "pty.node" module. 

Is article helpful?