mik-laj edited a comment on issue #14231: URL: https://github.com/apache/airflow/issues/14231#issuecomment-779610218
> Could be first chapter It cannot be long if it's going to be 5-10 minute installation it should be maximum one-two paragraph per system. This won't be two paragraphs when it comes to installing on Mac OS, because you need to install the correct version of the Python interpreter (probably using pyenv), PostgresSQL, Redis, OpenSSL, PostgresSQL Client, Rust compiler, GCC compiler, xcode tools, and possibly other dependencies. You need to create schema and user in the database. You need to set some options in the Airflow configuraitoon. That's all you have to do in the right order and preferably in one terminal session, because sometimes you need to set up environment variables to configure options for the compiler. Unfortunately, we have many dependencies that make configuration not easy. > My point is discoverability. "Installation" is the link that people will be following from the documentation. It could be separated out as separate document of course, but this is simply a variant of installation that we are talking about. We can change the position of the items in the menu, or add annotations that the easier guide is in another section.We currently have a page that has a similar purpose, but lacks an article that describes more Mac OS specific information. http://airflow.apache.org/docs/apache-airflow/stable/start/index.html After installation, the user has to take a few additional steps to be able to use Airflow, e.g. perform migrations, create a user, run the webserver and scheduler. It's a bit more than just the installation itself. http://airflow.apache.org/docs/apache-airflow/stable/start/docker.html#initializing-environment Please have a look at the article that describes installations in a containerized Docker environment - [docker-compose](http://airflow.apache.org/docs/apache-airflow/stable/start/docker.html#initializing-environment). This article contains the following sections: * **Before you begin** -described prerequisites. We do not have specific requirements here, so we can recommend official documentation. * **docker-compose.yaml** - a description of how to download the docker-compose.yaml file. If you have MacOS, you can run one command - `docker-compose up` to install Airflow * **Initializing Environment** - We also need to describe information specific to other operating systems, and docker-compose up is not a nice command as it generates a lot of logs, so I decided to create a new section. This is still an installation step. This is still the installation stage. * **Running Airflow** - Description of how to start Airflow, which is beyond the installation stage. This point is important for the user, so I also chose to include a sample result so that the user can compare with their result. * **Accessing the environment** - Description not only of how to start, but also how to perform some of the simplest operations in Airflow. * **Notes**/**What’s Next?** - Links to other helpful articles ---------------------------------------------------------------- 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. For queries about this service, please contact Infrastructure at: [email protected]
