cubejs/cube

https://cube.dev

https://cube.dev • https://docs.cube.dev • https://cube.dev/blog • https://slack.cube.dev • ***

Supported tags and respective Dockerfile links

Debian based: <version>, latest, dev

Quick reference

Where to get help? Check out our https://slack.cube.dev/, https://stackoverflow.com/search?q=cube.js or https://github.com/cube-js/cube.js/discussions pages.

Found an issue? File it on our GitHub Issues page.

Supported architectures: amd64

Need the documentation? Check out the https://docs.cube.dev.

What is Cube?

Cube is an open-source analytical API platform. It is primarily used to build internal business intelligence tools or add customer-facing analytics to existing applications.

Cube was designed to work with Serverless Query Engines like AWS Athena and Google BigQuery. Multi-stage querying approach makes it suitable for handling trillions of data points. Most modern RDBMS work with Cube as well and can be tuned for adequate performance.

Unlike others, it is not a monolith application, but a set of modules, which does one thing well. Cube provides modules to run transformations and modeling in data warehouse, querying and caching, managing API gateway and building UI on top of that.

How to use this image

Start a Cube instance

bash
docker pull cubejs/cube:latest
docker run -d -p 3000:3000 -p 4000:4000 \
  -e CUBEJS_DB_HOST=postgres://hostname \
  -e CUBEJS_DB_NAME=<DB_NAME> \
  -e CUBEJS_DB_USER=<USER> \
  -e CUBEJS_DB_PASS=<PASS> \
  -e CUBEJS_DB_TYPE=<DB_TYPE> \
  -e CUBEJS_API_SECRET=<API_SECRET> \
  -v $(pwd):/cube/conf \
  cubejs/cube:latest

The Cube Developer Playground will be available at http://localhost:4000. For more information about supported environment variables, please consult the documentation for https://docs.cube.dev/reference/configuration/environment-variables.

Using Docker Compose

yaml
version: '2.2'

services:
  cube:
    image: cubejs/cube:latest
    depends_on:
      - redis
    links:
      - redis
    ports:
      # It's better to use random port binding for 4000/3000 ports
      # without it you will not able to start multiple projects inside docker
      - 4000:4000  # Cube API and Developer Playground
      - 3000:3000  # Dashboard app, if created
    env_file: .env
    volumes:
      # If you are going to use own dependencies, for example axios/vault or anything else for getting configuration
      - .:/cube/conf

  redis:
    image: redis:6
    restart: always

License

Cube Docker is Apache 2.0 licensed.