History

Daniel Vaz Gaspar b6ab691ebd [docker] Fix docker-init missing FLASK_APP (#7709 )		2019-06-14 09:02:11 -07:00
..
.env	Add licenses to translations (#6732 )	2019-01-22 08:21:13 -08:00
Dockerfile	fixes #6353 by changing tag on base image (#7335 )	2019-04-20 13:17:52 -07:00
README.md	Rjurney master docs update (#7426 )	2019-05-20 17:06:08 -07:00
docker-compose.yml	SUPERSET-7: Docker compose config version breaks on Ubuntu 16.04 (#7359 )	2019-04-24 11:47:07 -07:00
docker-entrypoint.sh	Deprecate npm run backend-sync and related logic (#7211 )	2019-04-10 08:46:05 -07:00
docker-init.sh	[docker] Fix docker-init missing FLASK_APP (#7709 )	2019-06-14 09:02:11 -07:00
superset_config.py	Apply ASF licenses throughout the code base (#5800 )	2019-01-15 15:53:27 -08:00

README.md

Getting Start with Superset using Docker

Docker is an easy way to get stated with Superset.

Initializing Database

To initialize the database with a user and example charts, dashboards and datasets run:

SUPERSET_LOAD_EXAMPLES=yes docker-compose run --rm superset ./docker-init.sh

This may take a minute.

Normal Operation

To run the container, simply run:

docker-compose up

After several minutes for superset initialization to finish, you can open a browser and view http://localhost:8088 to start your journey.

Developing

While running, the container server will reload on modification of the superset python and javascript source code. Don't forget to reload the page to take the new frontend into account though.

Production

It is also possible to run Superset in non-development mode: in the docker-compose.yml file remove the volumes needed for development and change the variable SUPERSET_ENV to production.

Resource Constraints

If you are attempting to build on a Mac and it exits with 137 you need to increase your docker resources. OSX instructions: https://docs.docker.com/docker-for-mac/#advanced (Search for memory)