bubble/docs/local-launcher.md

Bubble Local Launcher Mode

A Bubble in Local Launcher Mode is the starting point for standing up a Bubble in Remote Launcher Mode, which you can then use to launch proper Bubbles in Bubble Node Mode.

Run Bubble

Run the ./bin/run.sh script on your local machine to start Bubble in Local Launcher mode. Once the server is running, it will try to open a browser window to continue configuration. It will also print out the URL, so if the browser doesn’t start correctly, you can paste this into your browser’s location bar.

Activation

Your Bubble is running locally in a “blank” mode. It needs an initial “root” account and some basic services configured.

Activate via Web UI

The browser-based admin UI should be displaying an “Activate” page. Complete the information on this page and submit the data. The Bubble Launcher will create an initial “root” account and other basic system configurations.

Activate via command line

Copy the file in config/activation.json, then edit the file. There are comments in the file to guide you. After saving the updated file, run this command:

./bin/bactivate /path/to/activation.json

After running the above, refresh the web page that opened when the server started. You should see a login page.

You can now login as the admin user using the email address root@local.local and the password from your activation.json file.

You are now read to Launch Bubble in Remote Launcher Mode