bubble-docs/admin/dev_setup.md

Bubble Development Environment

Initial Download and Build

For best results, start with a fresh Ubuntu 18.04. Either the Server or Desktop Ubuntu will work.

• Download the code: git clone https://git.bubblev.org/bubblev/bubble.git

• Run first-time operating system setup: ./bin/first_time_ubuntu.sh This command will install various apt packages required by Bubble, and configure/setup the initial Bubble PostgreSQL database. Note: this command only needs to be run once on a new Ubuntu 18.04 development system.

• Run first-time code setup: ./bin/first_time_setup.sh This command initializes the various git submodules used by Bubble, downloads all required maven dependencies, and performs an initial build. Note this command only need to be run once after a fresh clone the Bubble git repository.

Subsequent Updating and Building

If you have an existing Bubble git repository, and would like to update all code (including submodules) to the latest version, run:

`./bin/git_update_bubble.sh`

After this command completes, your Bubble will be updated to the latest development code, and rebuilt.

Environment file

You will need a file named ${HOME}/.bubble.env which contains various environment variables required to run the server.

Talk to another developer to get a copy of this file. Do not ever send this file over email or any other unencrypted channel. Always use scp to copy this file from one machine to another.

After you have the env file in place, create a symlink called ${HOME}/.bubble-test.env

cd ${HOME} && ln -s .bubble.env .bubble-test.env