Launching the App
Run the Server For Development
You can run your development environment using either docker or node:
- To run the widget with docker, run
docker compose up
. - To run the widget with node, run
npm run dev
.
The widget relies on redis. If you receive an error about failure to connect redis, start a local redis instance to make it available at localhost:6379 and the widget will be able to use it.
Deploying a Production Instance
For a production instance, it is easiest to use Docker. We provide docker files for both the server and the UI, along with a docker-compose file that runs all necessary containers, including Redis and ElasticSearch.
The simplest way to deploy this widget is via docker-compose, as shown below, but you can also use the dockerfiles directly.
Take a look at the docker-compose.yml file for more details on how it is set up.
docker compose up
Reminder About Sensitive Information
Secrets must be passed through environment variables instead of hardcoded in the code files.
Do not put any credentials in any of the code files. If you do so, it could get committed and leaked to the public.
Use the provided .env
files.