quick-start-install.asciidoc 2.6 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788
  1. // tag::cloud[]
  2. include::{docs-root}/shared/cloud/ess-getting-started.asciidoc[tag=generic]
  3. . Click **Continue** to open {kib}.
  4. . Click **Explore on my own**.
  5. // end::cloud[]
  6. // tag::self-managed[]
  7. **Install and run {es}**
  8. ifeval::["{release-state}"=="unreleased"]
  9. NOTE: No Docker image is currently available for {es} {version}.
  10. endif::[]
  11. ifeval::["{release-state}"!="unreleased"]
  12. . Install and start https://www.docker.com/products/docker-desktop[Docker
  13. Desktop].
  14. . Run:
  15. +
  16. [source,sh,subs="attributes"]
  17. ----
  18. docker network create elastic
  19. docker pull {docker-repo}:{version}
  20. docker run --name es01 --net elastic -p 9200:9200 -p 9300:9300 -it {docker-image}
  21. ----
  22. +
  23. When you start {es} for the first time, the following security configuration
  24. occurs automatically:
  25. +
  26. --
  27. * <<elasticsearch-security-certificates,Certificates and keys>> are generated
  28. for the transport and HTTP layers.
  29. * The Transport Layer Security (TLS) configuration settings are written to
  30. `elasticsearch.yml`.
  31. * A password is generated for the `elastic` user.
  32. * An enrollment token is generated for {kib}.
  33. NOTE: You might need to scroll back a bit in the terminal to view the password
  34. and enrollment token.
  35. --
  36. . Copy the generated password and enrollment token and save them in a secure
  37. location. These values are shown only when you start {es} for the first time.
  38. You'll use these to enroll {kib} with your {es} cluster and log in.
  39. +
  40. [NOTE]
  41. ====
  42. If you need to reset the password for the `elastic` user or other
  43. built-in users, run the <<reset-password,`elasticsearch-reset-password`>> tool.
  44. To generate new enrollment tokens for {kib} or {es} nodes, run the
  45. <<create-enrollment-token,`elasticsearch-create-enrollment-token`>> tool.
  46. These tools are available in the {es} `bin` directory.
  47. ====
  48. endif::[]
  49. **Install and run {kib}**
  50. To analyze, visualize, and manage {es} data using an intuitive UI, install
  51. {kib}.
  52. ifeval::["{release-state}"=="unreleased"]
  53. NOTE: No Docker image is currently available for {kib} {version}.
  54. endif::[]
  55. ifeval::["{release-state}"!="unreleased"]
  56. . In a new terminal session, run:
  57. +
  58. ["source","txt",subs="attributes"]
  59. ----
  60. docker pull docker.elastic.co/kibana/kibana:{version}
  61. docker run --name kibana --net elastic -p 5601:5601 docker.elastic.co/kibana/kibana:{version}
  62. ----
  63. +
  64. When you start {kib}, a unique link is output to your terminal.
  65. . To access {kib}, click the generated link in your terminal.
  66. .. In your browser, paste the enrollment token that you copied and click the button to connect your {kib} instance with {es}.
  67. .. Log in to {kib} as the `elastic` user with the password that was generated when you started {es}.
  68. endif::[]
  69. // end::self-managed[]