docs: add quickstart (#26129)

This commit is contained in:
Braum 2023-12-01 13:09:38 -03:00 committed by GitHub
parent b2ea97a984
commit 1b9e4ff9ab
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
8 changed files with 93 additions and 7 deletions

View File

@ -1,7 +1,7 @@
---
title: API
hide_title: true
sidebar_position: 9
sidebar_position: 10
---
import { Buffer } from 'buffer';

View File

@ -1,4 +1,4 @@
{
"label": "Contributing",
"position": 6
"position": 7
}

View File

@ -1,4 +1,4 @@
{
"label": "Connecting to Databases",
"position": 3
"position": 5
}

View File

@ -1,7 +1,7 @@
---
title: Frequently Asked Questions
hide_title: true
sidebar_position: 7
sidebar_position: 8
---
## Frequently Asked Questions

View File

@ -1,4 +1,4 @@
{
"label": "Installation and Configuration",
"position": 2
"position": 3
}

View File

@ -1,4 +1,4 @@
{
"label": "Miscellaneous",
"position": 5
"position": 6
}

86
docs/docs/quickstart.mdx Normal file
View File

@ -0,0 +1,86 @@
---
title: Quickstart
hide_title: false
sidebar_position: 2
---
**Ready to give Apache Superset a try?** This quickstart will help you run Superset on your local machine in
**5 simple steps**. It assumes that you have [Docker](https://www.docker.com) installed.
### 1. Get Superset
To get started, set the `SUPERSET_VERSION` environment variable with the latest Superset version.
[Click here](https://github.com/apache/superset/releases) to check the latest version.
```
$ export SUPERSET_VERSION=<latest_version>
```
Pull the Superset image from Docker Hub:
```
$ docker pull apache/superset:$SUPERSET_VERSION
```
### 2. Start Superset
:::tip
Note that some configuration is mandatory for Superset in order to start. In particular, Superset will not start without
a user-specified value of `SECRET_KEY` in a Superset configuration file or `SUPERSET_SECRET_KEY` as an environment variable.
Please see [Configuring Superset](https://superset.apache.org/docs/installation/configuring-superset/) for more details.
:::
```
$ docker run -d -p 8080:8088 \
-e "SUPERSET_SECRET_KEY=$(openssl rand -base64 42)" \
-e "TALISMAN_ENABLED=False" \
--name superset apache/superset:$SUPERSET_VERSION
```
### 3. Create an account
```
$ docker exec -it superset superset fab create-admin \
--username admin \
--firstname Admin \
--lastname Admin \
--email admin@localhost \
--password admin
```
### 4. Configure Superset
```
$ docker exec -it superset superset db upgrade &&
docker exec -it superset superset load_examples &&
docker exec -it superset superset init
```
:::tip
This step can take some time. While you wait, feel free to join the official Slack channel to check for new releases,
ask questions, and engage with the community.
[Click here to join.](https://apache-superset.slack.com/join/shared_invite/zt-26ol9ge4y-kzUnSo9inRepOay0ufBTsA#/shared-invite/email)
:::
### 5. Start using Superset
After configuring your fresh instance, head over to [http://localhost:8080](http://localhost:8080) and
log in with the default created account:
```
username: admin
password: admin
```
#### 🎉 Congratulations! Superset is now up and running on your machine! 🎉
### Wrapping Up
Once you're done with Superset, you can stop and remove it just like any other container:
```
$ docker container rm -f superset
```
:::tip
You can use the same container more than once, as Superset will persist data locally. However, make sure to properly stop all
processes by running Docker `stop` command. By doing so, you can avoid data corruption and/or loss of data.
:::
## What's next?
From this point on, you can head on to:
- [Create your first Dashboard](https://superset.apache.org/docs/creating-charts-dashboards/creating-your-first-dashboard)
- [Connect to a Database](https://superset.apache.org/docs/databases/installing-database-drivers)
- [Configure Superset](https://superset.apache.org/docs/installation/configuring-superset/)
Or just explore our Documentation!

View File

@ -1,4 +1,4 @@
{
"label": "Security",
"position": 10
"position": 9
}