superset/contrib/docker
Russell Jurney 023faf3b56 Rjurney master docs update (#7426)
* resolved conflict

* Docs updated re: Anaconda/certifi issue re #7373

* Removed --console-log "not working" note

* A note about Anaconda virtualenvs

* Make anaconda comment fit on page

* Added README to docker directory

* Added install doc reference to master copy of contrib/docker/README.md

* merged master, removed mysqlclient

* Removed mysql dependency, Anaconda and --console-log references

* Add cypress install command to cypress test instructions

* Fixed cypress instructions re: port 8081

* Removed anaconda reference, runserver references

* Remove anaconda reference

* Added back a self-contained version of mysqlclient to dev requirements

* Added ASF license to docker README.md
2019-05-20 17:06:08 -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 Add licenses to translations (#6732) 2019-01-22 08:21:13 -08: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)