Skip to content

feat: Add Docker setup for running kepler.gl demo app locally#3458

Merged
igorDykhta merged 2 commits into
masterfrom
igr/dockerize
May 26, 2026
Merged

feat: Add Docker setup for running kepler.gl demo app locally#3458
igorDykhta merged 2 commits into
masterfrom
igr/dockerize

Conversation

@igorDykhta
Copy link
Copy Markdown
Collaborator

Adds a docker/ directory with development and production Dockerfiles, a docker-compose file, and a README with usage instructions. Improves on #2986 by using local source (no git clone), Node 20, multi-stage production builds, and proper handling of the gl native package and xdg-open in containers. Also updates .dockerignore to reduce build context size.

Signed-off-by: Ihor Dykhta <ihordykhta@Ihors-MacBook-Pro.local>
@igorDykhta igorDykhta requested review from Copilot, ilyabo and lixun910 May 25, 2026 01:11
@igorDykhta igorDykhta self-assigned this May 25, 2026
@igorDykhta igorDykhta added the 3.3 Kepler.gl 3.3 release label May 25, 2026
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a docker/ setup to run the kepler.gl demo app locally via Docker, providing both a dev (watch) and production (static build) workflow.

Changes:

  • Added dev + prod Dockerfiles for building/running examples/demo-app.
  • Added a docker-compose configuration to start the demo app in dev or prod mode.
  • Updated .dockerignore to reduce Docker build context size.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 7 comments.

Show a summary per file
File Description
docker/README.md Documents Docker Compose and direct Docker workflows for dev/prod.
docker/Dockerfile.dev Defines a development image intended to run the demo app in watch mode.
docker/Dockerfile Defines a multi-stage production build that serves the static demo app via serve.
docker/docker-compose.yml Provides kepler-dev and kepler-prod compose services.
.dockerignore Excludes more repo directories from the Docker build context.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread docker/docker-compose.yml
Comment thread docker/docker-compose.yml Outdated
Comment thread docker/Dockerfile
Comment thread docker/Dockerfile
Comment thread docker/Dockerfile.dev Outdated
Comment thread docker/Dockerfile.dev Outdated
Comment thread docker/README.md
Signed-off-by: Ihor Dykhta <ihordykhta@Ihors-MacBook-Pro.local>
@igorDykhta igorDykhta merged commit f7cc780 into master May 26, 2026
9 checks passed
@igorDykhta igorDykhta deleted the igr/dockerize branch May 26, 2026 00:27
@jo-chemla
Copy link
Copy Markdown

Impressive to see there is now the option to deploy keplergl demo-app via Local Docker Compose (dev or prod)!

Quick question, are you also planning to allow for hosting the built docker container image (to ghcr.io or docker-hub)?
Would let people publish/deploy the demo-app via a simple docker-compose yaml, similar to the one of this PR, but without the need to clone the repo, or use the build/context flags and entries. See related discussion: #2836 and closed thread #2024.

Note it could be useful to open a dedicated github issue thread to gauge interest and let people watch for this one.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

3.3 Kepler.gl 3.3 release

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants