[[upgrade]]
== Upgrading Kibana

[IMPORTANT]
===========================================
Before upgrading Kibana:

* Consult the <<breaking-changes,breaking changes>> docs.
* Test upgrades in a dev environment before upgrading your production servers.
* Backup your data using the Elasticsearch
  {ref}/modules-snapshots.html[snapshots] feature.
  You **cannot roll back** to an earlier version unless you have a backup of
  your data.
* If you are using custom plugins, check that a compatible version is
  available.
===========================================

Depending on which version of Kibana you're upgrading from, the upgrade process
will vary. Please consult the following table to determine which process you
should follow:

[cols="1<m,1<m,3",options="header",]
|=======================================================================
|Upgrade From   |Upgrade To     |Supported Upgrade Type
|3.x            |5.x            |<<upgrade-new-install,New installation>>
|4.0 or 4.1     |5.x            |<<upgrade-standard-reindex,Standard upgrade & reindex>>
|4.x >= 4.2     |5.x            |<<upgrade-standard,Standard upgrade>>
|5.0.0 pre GA   |5.x            |<<upgrade-standard-reindex,Standard upgrade & reindex>>
|5.x            |5.y            |<<upgrade-standard,Standard upgrade>> (where `y > x`)
|5.x            |6.x            |<<upgrade-standard,Standard upgrade>>
// & <<migrating-6.0-index,Reindex transformation>>
|6.x            |6.y            |<<upgrade-standard,Standard upgrade>> (where `y > x`)
|6.x            |7.x            |<<upgrade-standard,Standard upgrade>>
|=======================================================================

NOTE: Saved searches, visualizations, and dashboards created in Kibana 4.x or 5.x
can be generally imported into 6.x.

include::upgrade/upgrade-standard.asciidoc[]

include::upgrade/upgrade-standard-reindex.asciidoc[]

include::upgrade/upgrade-new-install.asciidoc[]
