quick-start-install.asciidoc 2.6 KB

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