You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@superset.apache.org by "artofcomputing (via GitHub)" <gi...@apache.org> on 2023/11/29 11:53:40 UTC
[PR] docs: add quickstart [superset]
artofcomputing opened a new pull request, #26129:
URL: https://github.com/apache/superset/pull/26129
### SUMMARY
As per Discussion #25976 and [DISCUSS] sent over the [Apache dev mailing list](https://lists.apache.org/thread/7w51kd3fktgmx2mnjgk33y554zcbypb1), this PR creates a quickstart page, simplifying the installation process, and providing:
- Simplifying the installation method.
- Allowing users to get up and running a Superset instance faster.
While allowing us to:
- Split installation and configuration topics.
- Provide a stable playground for users to explore (by making the user to install a stable release of Superset).
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@superset.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@superset.apache.org
For additional commands, e-mail: notifications-help@superset.apache.org
Re: [PR] docs: add quickstart [superset]
Posted by "artofcomputing (via GitHub)" <gi...@apache.org>.
artofcomputing commented on code in PR #26129:
URL: https://github.com/apache/superset/pull/26129#discussion_r1412101934
##########
docs/docs/quickstart.mdx:
##########
@@ -0,0 +1,82 @@
+---
+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, add the latest Superset version in the `SUPERSET_VERSION` environment variable, and pull the container from Docker Hub:
+```
+$ export SUPERSET_VERSION="";
+ docker pull apache/superset:$SUPERSET_VERSION
+```
+:::tip
+Not sure what the latest stable Superset version is? [Click here](https://github.com/apache/superset/releases) to check our release page
+for up-to-date information.
+:::
+
+### 2. Start Superset
+```
+$ docker run -d -p 8080:8088 \
+ -e "SUPERSET_SECRET_KEY=$(openssl rand -base64 42)" \
+ -e "TALISMAN_ENABLED=False" \
+ --name superset apache/superset:$SUPERSET_VERSION
+```
+:::tip
Review Comment:
You mean the TALISMAN environment variable, or about the container version?
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@superset.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@superset.apache.org
For additional commands, e-mail: notifications-help@superset.apache.org
Re: [PR] docs: add quickstart [superset]
Posted by "artofcomputing (via GitHub)" <gi...@apache.org>.
artofcomputing commented on code in PR #26129:
URL: https://github.com/apache/superset/pull/26129#discussion_r1412101934
##########
docs/docs/quickstart.mdx:
##########
@@ -0,0 +1,82 @@
+---
+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, add the latest Superset version in the `SUPERSET_VERSION` environment variable, and pull the container from Docker Hub:
+```
+$ export SUPERSET_VERSION="";
+ docker pull apache/superset:$SUPERSET_VERSION
+```
+:::tip
+Not sure what the latest stable Superset version is? [Click here](https://github.com/apache/superset/releases) to check our release page
+for up-to-date information.
+:::
+
+### 2. Start Superset
+```
+$ docker run -d -p 8080:8088 \
+ -e "SUPERSET_SECRET_KEY=$(openssl rand -base64 42)" \
+ -e "TALISMAN_ENABLED=False" \
+ --name superset apache/superset:$SUPERSET_VERSION
+```
+:::tip
Review Comment:
You mean the TALISMAN environment variable, or about the container?
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@superset.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@superset.apache.org
For additional commands, e-mail: notifications-help@superset.apache.org
Re: [PR] docs: add quickstart [superset]
Posted by "artofcomputing (via GitHub)" <gi...@apache.org>.
artofcomputing commented on code in PR #26129:
URL: https://github.com/apache/superset/pull/26129#discussion_r1411159966
##########
docs/docs/quickstart.mdx:
##########
@@ -0,0 +1,76 @@
+---
+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
+```
+$ docker pull apache/superset:3.0.2
Review Comment:
@john-bodley @michael-s-molina made the change in the step 1 and 2 with commit [328e871](https://github.com/apache/superset/pull/26129/commits/328e8715016a5a5871a412dc6c6a4c703b18c9d2), and added a tip on how users can find the latest release
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@superset.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@superset.apache.org
For additional commands, e-mail: notifications-help@superset.apache.org
Re: [PR] docs: add quickstart [superset]
Posted by "artofcomputing (via GitHub)" <gi...@apache.org>.
artofcomputing commented on code in PR #26129:
URL: https://github.com/apache/superset/pull/26129#discussion_r1411133981
##########
docs/docs/quickstart.mdx:
##########
@@ -0,0 +1,76 @@
+---
+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
+```
+$ docker pull apache/superset:3.0.2
Review Comment:
That's reasonable, I'll add the placeholder with information on where to instruct users.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@superset.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@superset.apache.org
For additional commands, e-mail: notifications-help@superset.apache.org
Re: [PR] docs: add quickstart [superset]
Posted by "john-bodley (via GitHub)" <gi...@apache.org>.
john-bodley commented on code in PR #26129:
URL: https://github.com/apache/superset/pull/26129#discussion_r1409671322
##########
docs/docs/quickstart.mdx:
##########
@@ -0,0 +1,76 @@
+---
+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
+```
+$ docker pull apache/superset:3.0.2
Review Comment:
Is it possible to not pin the version, maybe something like:
```suggestion
$ docker pull apache/superset:<version>
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@superset.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@superset.apache.org
For additional commands, e-mail: notifications-help@superset.apache.org
Re: [PR] docs: add quickstart [superset]
Posted by "michael-s-molina (via GitHub)" <gi...@apache.org>.
michael-s-molina commented on code in PR #26129:
URL: https://github.com/apache/superset/pull/26129#discussion_r1412104768
##########
docs/docs/quickstart.mdx:
##########
@@ -0,0 +1,82 @@
+---
+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, add the latest Superset version in the `SUPERSET_VERSION` environment variable, and pull the container from Docker Hub:
+```
+$ export SUPERSET_VERSION="";
+ docker pull apache/superset:$SUPERSET_VERSION
+```
+:::tip
+Not sure what the latest stable Superset version is? [Click here](https://github.com/apache/superset/releases) to check our release page
+for up-to-date information.
+:::
+
+### 2. Start Superset
+```
+$ docker run -d -p 8080:8088 \
+ -e "SUPERSET_SECRET_KEY=$(openssl rand -base64 42)" \
+ -e "TALISMAN_ENABLED=False" \
+ --name superset apache/superset:$SUPERSET_VERSION
+```
+:::tip
Review Comment:
I mean placing the tip before the command:
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
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@superset.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@superset.apache.org
For additional commands, e-mail: notifications-help@superset.apache.org
Re: [PR] docs: add quickstart [superset]
Posted by "michael-s-molina (via GitHub)" <gi...@apache.org>.
michael-s-molina commented on code in PR #26129:
URL: https://github.com/apache/superset/pull/26129#discussion_r1410687145
##########
docs/docs/quickstart.mdx:
##########
@@ -0,0 +1,76 @@
+---
+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
+```
+$ docker pull apache/superset:3.0.2
Review Comment:
I think we could:
- Fix the `latest` tag to point only to Superset versions instead of Helm charts
- In the documentation, use a placeholder like `<latest>` and instruct users to check what's the latest version
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@superset.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@superset.apache.org
For additional commands, e-mail: notifications-help@superset.apache.org
Re: [PR] docs: add quickstart [superset]
Posted by "michael-s-molina (via GitHub)" <gi...@apache.org>.
michael-s-molina merged PR #26129:
URL: https://github.com/apache/superset/pull/26129
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@superset.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@superset.apache.org
For additional commands, e-mail: notifications-help@superset.apache.org
Re: [PR] docs: add quickstart [superset]
Posted by "michael-s-molina (via GitHub)" <gi...@apache.org>.
michael-s-molina commented on code in PR #26129:
URL: https://github.com/apache/superset/pull/26129#discussion_r1412057207
##########
docs/docs/quickstart.mdx:
##########
@@ -0,0 +1,82 @@
+---
+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, add the latest Superset version in the `SUPERSET_VERSION` environment variable, and pull the container from Docker Hub:
+```
+$ export SUPERSET_VERSION="";
+ docker pull apache/superset:$SUPERSET_VERSION
+```
+:::tip
+Not sure what the latest stable Superset version is? [Click here](https://github.com/apache/superset/releases) to check our release page
+for up-to-date information.
+:::
Review Comment:
Maybe this would be more intuitive?
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
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@superset.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@superset.apache.org
For additional commands, e-mail: notifications-help@superset.apache.org
Re: [PR] docs: add quickstart [superset]
Posted by "sfirke (via GitHub)" <gi...@apache.org>.
sfirke commented on PR #26129:
URL: https://github.com/apache/superset/pull/26129#issuecomment-1836538244
Sorry I didn't get my review in earlier - but it's okay because it looks great! Fantastic work @artofcomputing !! And thanks @michael-s-molina and @john-bodley for the feedback. I like having the users check the latest and specify that version manually.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@superset.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@superset.apache.org
For additional commands, e-mail: notifications-help@superset.apache.org
Re: [PR] docs: add quickstart [superset]
Posted by "artofcomputing (via GitHub)" <gi...@apache.org>.
artofcomputing commented on code in PR #26129:
URL: https://github.com/apache/superset/pull/26129#discussion_r1412088211
##########
docs/docs/quickstart.mdx:
##########
@@ -0,0 +1,82 @@
+---
+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, add the latest Superset version in the `SUPERSET_VERSION` environment variable, and pull the container from Docker Hub:
+```
+$ export SUPERSET_VERSION="";
+ docker pull apache/superset:$SUPERSET_VERSION
+```
+:::tip
+Not sure what the latest stable Superset version is? [Click here](https://github.com/apache/superset/releases) to check our release page
+for up-to-date information.
+:::
Review Comment:
Yeah that's better, I just changed the first step to it
<img width="863" alt="image" src="https://github.com/apache/superset/assets/45772806/ebfbbab9-c884-4382-94a6-8b304c151355">
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@superset.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@superset.apache.org
For additional commands, e-mail: notifications-help@superset.apache.org
Re: [PR] docs: add quickstart [superset]
Posted by "artofcomputing (via GitHub)" <gi...@apache.org>.
artofcomputing commented on code in PR #26129:
URL: https://github.com/apache/superset/pull/26129#discussion_r1409689872
##########
docs/docs/quickstart.mdx:
##########
@@ -0,0 +1,76 @@
+---
+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
+```
+$ docker pull apache/superset:3.0.2
Review Comment:
Right now it's possible but it would require versioning the documentation. The pinning is done currently to "stabilize" versions as not to let the latest tag be used, since that is currently bound to the master branch, instead of the latest release.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@superset.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@superset.apache.org
For additional commands, e-mail: notifications-help@superset.apache.org
Re: [PR] docs: add quickstart [superset]
Posted by "john-bodley (via GitHub)" <gi...@apache.org>.
john-bodley commented on code in PR #26129:
URL: https://github.com/apache/superset/pull/26129#discussion_r1410004615
##########
docs/docs/quickstart.mdx:
##########
@@ -0,0 +1,76 @@
+---
+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
+```
+$ docker pull apache/superset:3.0.2
Review Comment:
@artofcomputing the challenge is, without a 🔮, we can't be certain what the upstream version is, i.e., it could be 3.1 or 4.0.
##########
docs/docs/quickstart.mdx:
##########
@@ -0,0 +1,76 @@
+---
+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
+```
+$ docker pull apache/superset:3.0.2
Review Comment:
@artofcomputing the challenge is, without a 🔮, we can't be certain what the upstream version is, i.e., it could be 3.1 or 4.0.
##########
docs/docs/quickstart.mdx:
##########
@@ -0,0 +1,76 @@
+---
+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
+```
+$ docker pull apache/superset:3.0.2
Review Comment:
@artofcomputing the challenge is, without a 🔮, we can't be certain what the upstream version is, e.g. it could be 3.1 or 4.0.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@superset.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@superset.apache.org
For additional commands, e-mail: notifications-help@superset.apache.org
Re: [PR] docs: add quickstart [superset]
Posted by "artofcomputing (via GitHub)" <gi...@apache.org>.
artofcomputing commented on code in PR #26129:
URL: https://github.com/apache/superset/pull/26129#discussion_r1410049611
##########
docs/docs/quickstart.mdx:
##########
@@ -0,0 +1,76 @@
+---
+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
+```
+$ docker pull apache/superset:3.0.2
Review Comment:
True, there's no way to tell. IMO we could define a semantic rule to favor the latest major version on the page, and minor/patch versions if there's no new major updates. But yeah, that would require manual bumps, or some other way, like <version> as you mentioned and let user manually set it. Any thoughts?
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@superset.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@superset.apache.org
For additional commands, e-mail: notifications-help@superset.apache.org
Re: [PR] docs: add quickstart [superset]
Posted by "michael-s-molina (via GitHub)" <gi...@apache.org>.
michael-s-molina commented on code in PR #26129:
URL: https://github.com/apache/superset/pull/26129#discussion_r1412059437
##########
docs/docs/quickstart.mdx:
##########
@@ -0,0 +1,82 @@
+---
+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, add the latest Superset version in the `SUPERSET_VERSION` environment variable, and pull the container from Docker Hub:
+```
+$ export SUPERSET_VERSION="";
+ docker pull apache/superset:$SUPERSET_VERSION
+```
+:::tip
+Not sure what the latest stable Superset version is? [Click here](https://github.com/apache/superset/releases) to check our release page
+for up-to-date information.
+:::
+
+### 2. Start Superset
+```
+$ docker run -d -p 8080:8088 \
+ -e "SUPERSET_SECRET_KEY=$(openssl rand -base64 42)" \
+ -e "TALISMAN_ENABLED=False" \
+ --name superset apache/superset:$SUPERSET_VERSION
+```
+:::tip
Review Comment:
Maybe this should be placed before the command so users set the config before running.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@superset.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@superset.apache.org
For additional commands, e-mail: notifications-help@superset.apache.org
Re: [PR] docs: add quickstart [superset]
Posted by "artofcomputing (via GitHub)" <gi...@apache.org>.
artofcomputing commented on code in PR #26129:
URL: https://github.com/apache/superset/pull/26129#discussion_r1412111582
##########
docs/docs/quickstart.mdx:
##########
@@ -0,0 +1,82 @@
+---
+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, add the latest Superset version in the `SUPERSET_VERSION` environment variable, and pull the container from Docker Hub:
+```
+$ export SUPERSET_VERSION="";
+ docker pull apache/superset:$SUPERSET_VERSION
+```
+:::tip
+Not sure what the latest stable Superset version is? [Click here](https://github.com/apache/superset/releases) to check our release page
+for up-to-date information.
+:::
+
+### 2. Start Superset
+```
+$ docker run -d -p 8080:8088 \
+ -e "SUPERSET_SECRET_KEY=$(openssl rand -base64 42)" \
+ -e "TALISMAN_ENABLED=False" \
+ --name superset apache/superset:$SUPERSET_VERSION
+```
+:::tip
Review Comment:
Ah, that can be done too, just made the change on commit https://github.com/apache/superset/pull/26129/commits/229bf700e80ab2d49d49b4eaecfeea8ee3415c20
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@superset.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@superset.apache.org
For additional commands, e-mail: notifications-help@superset.apache.org
Re: [PR] docs: add quickstart [superset]
Posted by "artofcomputing (via GitHub)" <gi...@apache.org>.
artofcomputing commented on code in PR #26129:
URL: https://github.com/apache/superset/pull/26129#discussion_r1409689872
##########
docs/docs/quickstart.mdx:
##########
@@ -0,0 +1,76 @@
+---
+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
+```
+$ docker pull apache/superset:3.0.2
Review Comment:
Right now it's possible but it would require versioning the documentation (which would be a can of worms in itself). The pinning is done currently to "stabilize" versions as not to let the latest tag be used, since that is currently bound to the master branch, instead of the latest release.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@superset.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@superset.apache.org
For additional commands, e-mail: notifications-help@superset.apache.org
Re: [PR] docs: add quickstart [superset]
Posted by "artofcomputing (via GitHub)" <gi...@apache.org>.
artofcomputing commented on code in PR #26129:
URL: https://github.com/apache/superset/pull/26129#discussion_r1409700290
##########
docs/docs/quickstart.mdx:
##########
@@ -0,0 +1,76 @@
+---
+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
+```
+$ docker pull apache/superset:3.0.2
Review Comment:
Something that we could do (just an idea) would be to update the version in the docs with every release, and prioritize the latest upstream version (e.g 3.1 instead of 3.0.3)
@sfirke @michael-s-molina @rusackas would that be feasible?
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@superset.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@superset.apache.org
For additional commands, e-mail: notifications-help@superset.apache.org