mirror of
https://github.com/apache/superset.git
synced 2024-09-18 11:39:49 -04:00
023faf3b56
* 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
59 lines
1.9 KiB
Markdown
59 lines
1.9 KiB
Markdown
<!--
|
|
Licensed to the Apache Software Foundation (ASF) under one
|
|
or more contributor license agreements. See the NOTICE file
|
|
distributed with this work for additional information
|
|
regarding copyright ownership. The ASF licenses this file
|
|
to you under the Apache License, Version 2.0 (the
|
|
"License"); you may not use this file except in compliance
|
|
with the License. You may obtain a copy of the License at
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
Unless required by applicable law or agreed to in writing,
|
|
software distributed under the License is distributed on an
|
|
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
|
KIND, either express or implied. See the License for the
|
|
specific language governing permissions and limitations
|
|
under the License.
|
|
-->
|
|
|
|
# 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:
|
|
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
docker-compose up
|
|
```
|
|
|
|
After several minutes for superset initialization to finish, you can open a browser and view [`http://localhost:8088`](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)
|