bubble/docs/local-launcher.md

Bubble Local Launcher Mode

A Bubble in Local Launcher Mode is the starting point for standing up any kind of Bubble.

You can use a Local Launcher to:

• Start a new Bubble directly in Node Mode
• Start a new Bubble in Remote Launcher Mode which can then launch new Bubbles in 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.

Follow the Bubble Activation instructions to configure your Bubble.

Resetting everything

If you want undo activation and “start over” with a blank Bubble: first, if your local bubble is still running, stop it. Then, run:

 ./bin/reset_bubble_full

This will remove local files stored by Bubble, and drop the bubble database.

If you run ./bin/run.sh again, it will be like running it for the first time.

Next Steps

You are now read to launch a new Bubble in Node Mode, or a Remote Launcher via Remote Launcher Mode