2019-06-11 01:22:51 +02:00
[[code-getting-started]]
== Getting Started with Code
2019-09-06 22:09:39 +02:00
The easiest way to get started with *Code* is to import a real-world repository.
2019-06-11 01:22:51 +02:00
[float]
==== Before you begin
You must have a {kib} instance up and running.
2019-06-14 23:53:07 +02:00
If you are in an environment where you have multiple {kib} instances in a cluster, see the <<code-multiple-kibana-instances-config, config instructions for multiple Kibana instances>>.
2019-06-11 01:22:51 +02:00
2019-06-15 00:32:30 +02:00
[float]
==== Enable Code app
2019-09-06 22:09:39 +02:00
While in beta, you can turn on *Code* by adding the following line to `kibana.yaml`:
2019-06-15 00:32:30 +02:00
[source,yaml]
----
xpack.code.ui.enabled: true
----
2019-06-11 01:22:51 +02:00
[float]
==== Import your first repository
2019-09-06 22:09:39 +02:00
. In {Kib}, navigate to *Code*.
2019-06-11 01:22:51 +02:00
2019-06-14 23:53:07 +02:00
. In the *Repository URL* field, paste the following GitHub clone URL:
2019-06-11 01:22:51 +02:00
+
[source,bash]
----
https://github.com/Microsoft/TypeScript-Node-Starter
----
2019-09-06 22:09:39 +02:00
`https` is recommend for cloning git repositories.
2019-06-11 01:22:51 +02:00
. Click *Import*.
+
2019-06-14 23:53:07 +02:00
A new item in the list displays the cloning and indexing progress of the `TypeScript-Node-Starter` repo.
2019-06-11 01:22:51 +02:00
+
[role="screenshot"]
image::images/code-import-repo.png[]
. After the indexing is complete, navigate to the repo by clicking its name in the list.
+
[role="screenshot"]
image::images/code-starter-root.png[]
+
Congratulations! You just imported your first repo into *Code*.
include::code-repo-management.asciidoc[]