overview

Author: shainaraskas

deploy-manage/deploy/deployment-comparison.md

@@ -1,5 +1,5 @@
 
-# Compare deployment options
+# Detailed deployment comparison
 
 This reference provides detailed comparisons of features and capabilities across Elastic's deployment options: self-managed deployments, Elastic Cloud Hosted, and Serverless. For a high-level overview of deployment types and guidance on choosing between them, see the [overview](../deploy.md).
 

deploy-manage/deploy/self-managed.md

@@ -7,4 +7,103 @@ sub:
 
 # Self-managed cluster 
 
+If you want to install Elastic on your own premises without the assistance of an [orchestrator](/deploy-manage/deploy.md#about-orchestration), then you can deploy a self-managed cluster. If you deploy a self-managed cluster, then you have complete control and responsibility over every aspect of your Elastic deployment.
 
+To quickly set up {{es}} and {{kib}} in Docker for local development or testing, jump to [](/deploy-manage/deploy/self-managed/local-development-installation-quickstart.md).
+
+:::{admonition} Simplify the deployment process
+Self-managed clusters are useful for local development, and for exploring Elastic features. However, Elastic offer several deployment options that can simplify the process of deploying and managing multi-node deployments, especially in production. They also allow you to deploy and manage multiple deployments from a single surface.
+
+Managed by Elastic: 
+* [{{serverless-full}}](/deploy-manage/deploy/elastic-cloud/serverless.md)
+* [{{ech}}](/deploy-manage/deploy/elastic-cloud/cloud-hosted.md)
+
+Self-hosted options:
+* [{{eck}}](/deploy-manage/deploy/cloud-on-k8s.md)
+* [{{ece}}](/deploy-manage/deploy/cloud-enterprise.md)
+
+For a comparison of these deployment options, refer to [Choosing your deployment type](/deploy-manage/deploy#choosing-your-deployment-type.md) and [](/deploy-manage/deploy/deployment-comparison.md).
+:::
+
+## Section overview
+
+This section focuses on deploying {{es}} and {{kib}} without an orchestrator.
+
+Depending on your use case, you might need to deploy other components, such as APM, Fleet, or Logstash. Deploying those components is not covered in this section. [Learn more about optional components](/get-started/the-stack.md).
+
+This section covers the following tasks: 
+
+### Deploying Elasticsearch
+
+Learn how to install and configure {{es}}. {{es}} is the distributed search and analytics engine, scalable data store, and vector database at the heart of all Elastic solutions.
+
+* [](/deploy-manage/deploy/self-managed/deploy-cluster.md)
+  * [](/deploy-manage/deploy/self-managed/important-system-configuration.md): Prepare your environment for an {{es}} installation.
+  * [](/deploy-manage/deploy/self-managed/installing-elasticsearch.md): Install and run {{es}} using one of our install packages or container images.
+  * [](/deploy-manage/deploy/self-managed/local-development-installation-quickstart.md): Quickly set up {{es}} and {{kib}} in Docker for local development or testing.
+* [](/deploy-manage/deploy/self-managed/configure-elasticsearch.md): Learn how to make configuration changes to {{es}}
+  * [](/deploy-manage/deploy/self-managed/important-settings-configuration.md): Learn about key settings required for production environments.
+  * [](/deploy-manage/deploy/self-managed/plugins.md): Learn about how to extend {{es}} functionality with plugins.
+
+    :::{note}
+    For a complete list of settings that you can apply to your {{es}} cluster, refer to the [Elasticsearch configuration reference](elasticsearch://reference/elasticsearch/configuration-reference.md).
+    :::
+
+### Deploying Kibana
+
+After you deploy {{es}}, you can install {{kib}}. {{kib}} provides the user interface for all Elastic solutions. It’s a powerful tool for visualizing and analyzing your data, and for managing and monitoring the {{stack}}. Although {{kib}} is not required to use {{es}}, it's required for most use cases.
+
+* [](/deploy-manage/deploy/self-managed/install-kibana.md): Install {{kib}} using one of our install packages or container images, and enroll {{kib}} with your {{es}} cluster.
+* [](/deploy-manage/deploy/self-managed/configure-kibana.md): Learn how to make configuration changes to {{kib}}.
+* [](/deploy-manage/deploy/self-managed/access-kibana.md): Learn how to access {{kib}} using a web browser.
+
+### Installing in air gapped environments
+
+Some components of the {{stack}} require additional configuration and local dependencies in order to deploy in environments without internet access. 
+
+Refer to [](/deploy-manage/deploy/self-managed/air-gapped-install.md) to learn how to install {{es}}, {{kib}}, and optional components in an environment without internet access.
+
+### Tools and APIs
+
+Review a list of all of the resources that you can use to interact with your self-managed cluster, including tools, APIs, client libraries, and more.
+
+[](/deploy-manage/deploy/self-managed/tools-apis.md).
+
+## Other important sections
+
+Review these other sections for critical information about securing and managing your self-managed cluster.
+
+### Secure and control access
+
+Learn how to secure your Elastic environment to restrict access to only authorized parties, and allow communication between your environment and external parties.
+
+* [](/deploy-manage/security.md): Learn about security features that prevent bad actors from tampering with your data, and encrypt communications to, from, and within your cluster.
+* [](/deploy-manage/users-roles.md): Set up authentication and authorization for your cluster, and learn about the underlying security technologies that {{es}} uses to authenticate and authorize requests internally and across services.
+* [](/deploy-manage/manage-spaces.md): Learn how to organize content in {{kib}}, and restrict access to this content to specific users.
+* [](/deploy-manage/api-keys.md): Authenticate and authorize programmatic access to your deployments and {{es}} resources.
+* [](/deploy-manage/manage-connectors.md): Manage connection information between Elastic and third-party systems.
+* [](/deploy-manage/remote-clusters.md): Enable communication between {{es}} clusters to support [cross-cluster replication](/deploy-manage/tools/cross-cluster-replication.md) and [cross-cluster search](/solutions/search/cross-cluster-search.md).
+
+### Administer and maintain
+
+Monitor the performance of your Elastic environment, administer your license, set up backup and resilience tools, and maintain the health of your environment.
+
+* [](/deploy-manage/tools.md): Learn about the tools available to safeguard data, ensure continuous availability, and maintain resilience in your {{es}} environment.
+* [](/deploy-manage/monitor.md): View health and performance data for Elastic components, and receive recommendations and insights.
+* [](/deploy-manage/license.md): Learn how to manage your Elastic license.
+* [](/deploy-manage/maintenance.md): Learn how to isolate or deactivate parts of your Elastic environment to perform maintenance, or restart parts of Elastic.
+
+### Upgrade
+
+You can [upgrade your Elastic environment](/deploy-manage/upgrade.md) to gain access to the latest features. Learn how to upgrade your cluster or deployment to the latest {{stack}} version, or upgrade your {{ece}} orchestrator or {{eck}} operator to the latest version.
+
+### Design guidance
+
+Learn how to design a production-ready Elastic environment.
+
+* [](/deploy-manage/production-guidance.md): Review tips and guidance that you can use to design a production environment that matches your workloads, policies, and deployment needs.
+* [](/deploy-manage/reference-architectures.md): Explore blueprints for deploying clusters tailored to different use cases.
+
+### Architectural information
+
+In the [](/deploy-manage/distributed-architecture.md) section, learn about the architecture of {{es}} and {{kib}}, and how Elastic stores and retrieves data and executes tasks in clusters with multiple nodes.

deploy-manage/deploy/self-managed/access-kibana.md

@@ -9,7 +9,7 @@ Access {{kib}} through the web application on port 5601.
 
 1. Point your web browser to the machine where you are running {{kib}} and specify the port number. For example, `localhost:5601` or `http://YOURDOMAIN.com:5601`.
 
-    To remotely connect to {{kib}}, set [server.host](configure.md#server-host) to a non-loopback address.
+    To remotely connect to {{kib}}, set [`server.host`](kibana://reference/configuration-reference/general-settings.md#server-host) to a non-loopback address.
 
 2. Log on to your account.
 3. Go to the home page, then click **{{kib}}**.

deploy-manage/deploy/self-managed/tools-apis.md

@@ -1,4 +1,10 @@
-# Tools and APIs
+---
+navigation_title: "Tools and APIs"
+applies_to:
+  deployment:
+    self:
+---
+# Tools and APIs for self-managed clusters
 
 % What needs to be done: Write from scratch