kibana/docs
Dima Arnautov 7da29174c7
[8.18] Support local file path for xpack.productDocBase.artifactRepositoryUrl (#217046) (#224284)
# Backport

This will backport the following commits from `main` to `8.18`:
- [Support local file path for
`xpack.productDocBase.artifactRepositoryUrl`
(#217046)](https://github.com/elastic/kibana/pull/217046)

<!--- Backport version: 10.0.1 -->

### Questions ?
Please refer to the [Backport tool
documentation](https://github.com/sorenlouv/backport)

<!--BACKPORT [{"author":{"name":"Dima
Arnautov","email":"dmitrii.arnautov@elastic.co"},"sourceCommit":{"committedDate":"2025-04-14T13:27:41Z","message":"Support
local file path for `xpack.productDocBase.artifactRepositoryUrl`
(#217046)\n\n## Summary\n\nCloses
https://github.com/elastic/kibana/issues/216583\n\nAdds support for a
local file path in\n`xpack.productDocBase.artifactRepositoryUrl`
setting.\nIf local path with `file://` protocol is provided, it has to
contain a\npath to a directory with the artifacts and the `index.xml`
file.\n\n#### How to test \n\n1. Download the XML and zip files
from\nhttps://kibana-knowledge-base-artifacts.elastic.co\n2. Create a
folder, e.g. `mkdir /Users/<my_user>/test_artifacts` and\nplace all the
files there. The XML file has to be called `index.xml`\n3. Add
`xpack.productDocBase.artifactRepositoryUrl:\n'file:///Users/<my_user>/test_artifacts'`
to your `kibana.dev.yml`\n4. Go to
`/app/management/kibana/observabilityAiAssistantManagement` in\nKibana
and install Elastic documentation\n5. Kibana dev server should report
`[2025-04-07T14:05:10.640+02:00][INFO\n][plugins.productDocBase.package-installer]
Documentation installation\nsuccessful for product [security] and
version [8.17]`\n6. Check `data/ai-kb-artifacts` folder in your Kibana
repo, it should\ncontain zip files with docs\n\n### Checklist\n\n- [x]
Any text added follows [EUI's
writing\nguidelines](https://elastic.github.io/eui/#/guidelines/writing),
uses\nsentence case text and includes
[i18n\nsupport](https://github.com/elastic/kibana/blob/main/src/platform/packages/shared/kbn-i18n/README.md)\n-
[x]\n[Documentation](https://www.elastic.co/guide/en/kibana/master/development-documentation.html)\nwas
added for features that require explanation or tutorials\n- [x] [Unit or
functional\ntests](https://www.elastic.co/guide/en/kibana/master/development-tests.html)\nwere
updated or added to match the most common scenarios\n- [x] The PR
description includes the appropriate Release Notes section,\nand the
correct `release_note:*` label is applied per
the\n[guidelines](https://www.elastic.co/guide/en/kibana/master/contributing.html#kibana-release-notes-process)","sha":"6722f142a4d36f0c84c9eb258287900f2f559389","branchLabelMapping":{"^v9.1.0$":"main","^v8.19.0$":"8.x","^v(\\d+).(\\d+).\\d+$":"$1.$2"}},"sourcePullRequest":{"labels":["release_note:enhancement",":ml","Team:ML","backport:version","v9.1.0","v8.19.0"],"title":"Support
local file path for
`xpack.productDocBase.artifactRepositoryUrl`","number":217046,"url":"https://github.com/elastic/kibana/pull/217046","mergeCommit":{"message":"Support
local file path for `xpack.productDocBase.artifactRepositoryUrl`
(#217046)\n\n## Summary\n\nCloses
https://github.com/elastic/kibana/issues/216583\n\nAdds support for a
local file path in\n`xpack.productDocBase.artifactRepositoryUrl`
setting.\nIf local path with `file://` protocol is provided, it has to
contain a\npath to a directory with the artifacts and the `index.xml`
file.\n\n#### How to test \n\n1. Download the XML and zip files
from\nhttps://kibana-knowledge-base-artifacts.elastic.co\n2. Create a
folder, e.g. `mkdir /Users/<my_user>/test_artifacts` and\nplace all the
files there. The XML file has to be called `index.xml`\n3. Add
`xpack.productDocBase.artifactRepositoryUrl:\n'file:///Users/<my_user>/test_artifacts'`
to your `kibana.dev.yml`\n4. Go to
`/app/management/kibana/observabilityAiAssistantManagement` in\nKibana
and install Elastic documentation\n5. Kibana dev server should report
`[2025-04-07T14:05:10.640+02:00][INFO\n][plugins.productDocBase.package-installer]
Documentation installation\nsuccessful for product [security] and
version [8.17]`\n6. Check `data/ai-kb-artifacts` folder in your Kibana
repo, it should\ncontain zip files with docs\n\n### Checklist\n\n- [x]
Any text added follows [EUI's
writing\nguidelines](https://elastic.github.io/eui/#/guidelines/writing),
uses\nsentence case text and includes
[i18n\nsupport](https://github.com/elastic/kibana/blob/main/src/platform/packages/shared/kbn-i18n/README.md)\n-
[x]\n[Documentation](https://www.elastic.co/guide/en/kibana/master/development-documentation.html)\nwas
added for features that require explanation or tutorials\n- [x] [Unit or
functional\ntests](https://www.elastic.co/guide/en/kibana/master/development-tests.html)\nwere
updated or added to match the most common scenarios\n- [x] The PR
description includes the appropriate Release Notes section,\nand the
correct `release_note:*` label is applied per
the\n[guidelines](https://www.elastic.co/guide/en/kibana/master/contributing.html#kibana-release-notes-process)","sha":"6722f142a4d36f0c84c9eb258287900f2f559389"}},"sourceBranch":"main","suggestedTargetBranches":[],"targetPullRequestStates":[{"branch":"main","label":"v9.1.0","branchLabelMappingKey":"^v9.1.0$","isSourceBranch":true,"state":"MERGED","url":"https://github.com/elastic/kibana/pull/217046","number":217046,"mergeCommit":{"message":"Support
local file path for `xpack.productDocBase.artifactRepositoryUrl`
(#217046)\n\n## Summary\n\nCloses
https://github.com/elastic/kibana/issues/216583\n\nAdds support for a
local file path in\n`xpack.productDocBase.artifactRepositoryUrl`
setting.\nIf local path with `file://` protocol is provided, it has to
contain a\npath to a directory with the artifacts and the `index.xml`
file.\n\n#### How to test \n\n1. Download the XML and zip files
from\nhttps://kibana-knowledge-base-artifacts.elastic.co\n2. Create a
folder, e.g. `mkdir /Users/<my_user>/test_artifacts` and\nplace all the
files there. The XML file has to be called `index.xml`\n3. Add
`xpack.productDocBase.artifactRepositoryUrl:\n'file:///Users/<my_user>/test_artifacts'`
to your `kibana.dev.yml`\n4. Go to
`/app/management/kibana/observabilityAiAssistantManagement` in\nKibana
and install Elastic documentation\n5. Kibana dev server should report
`[2025-04-07T14:05:10.640+02:00][INFO\n][plugins.productDocBase.package-installer]
Documentation installation\nsuccessful for product [security] and
version [8.17]`\n6. Check `data/ai-kb-artifacts` folder in your Kibana
repo, it should\ncontain zip files with docs\n\n### Checklist\n\n- [x]
Any text added follows [EUI's
writing\nguidelines](https://elastic.github.io/eui/#/guidelines/writing),
uses\nsentence case text and includes
[i18n\nsupport](https://github.com/elastic/kibana/blob/main/src/platform/packages/shared/kbn-i18n/README.md)\n-
[x]\n[Documentation](https://www.elastic.co/guide/en/kibana/master/development-documentation.html)\nwas
added for features that require explanation or tutorials\n- [x] [Unit or
functional\ntests](https://www.elastic.co/guide/en/kibana/master/development-tests.html)\nwere
updated or added to match the most common scenarios\n- [x] The PR
description includes the appropriate Release Notes section,\nand the
correct `release_note:*` label is applied per
the\n[guidelines](https://www.elastic.co/guide/en/kibana/master/contributing.html#kibana-release-notes-process)","sha":"6722f142a4d36f0c84c9eb258287900f2f559389"}},{"branch":"8.x","label":"v8.19.0","branchLabelMappingKey":"^v8.19.0$","isSourceBranch":false,"state":"NOT_CREATED"},{"url":"https://github.com/elastic/kibana/pull/219083","number":219083,"branch":"8.19","state":"MERGED","mergeCommit":{"sha":"de3d30aeda57436d96a0d6142e315bc076376657","message":"[8.19]
Support local file path for `xpack.productDocBase.artifactRepositoryUrl`
(#217046) (#219083)\n\n# Backport\n\nThis will backport the following
commits from `main` to `8.19`:\n- [Support local file path
for\n`xpack.productDocBase.artifactRepositoryUrl`\n(#217046)](https://github.com/elastic/kibana/pull/217046)\n\n\n\n###
Questions ?\nPlease refer to the [Backport
tool\ndocumentation](https://github.com/sorenlouv/backport)\n\n\n\nCo-authored-by:
Elastic Machine <elasticmachine@users.noreply.github.com>"}}]}]
BACKPORT-->
2025-06-17 19:29:30 +02:00
..
api [8.18] [DOCS] Remove Upgrade Assistant add default field API (#217264) (#217372) 2025-04-08 11:14:20 -04:00
canvas [8.x] [Docs] Update nav instructions and sample data installation to accommodate for the solution views (#199163) (#199438) 2024-11-08 10:41:00 +00:00
concepts [8.x] [DOCS] Give finding apps and objects section an ID (#199352) (#208721) 2025-01-29 11:45:00 +00:00
dev-tools [8.x] [Docs] Update nav instructions and sample data installation to accommodate for the solution views (#199163) (#199438) 2024-11-08 10:41:00 +00:00
developer [8.18] Fix plugin list for 8.x (asciidoc-based) docs (#215671) (#215703) 2025-03-25 11:44:32 +01:00
development/plugins/expressions/public Remove old doc generation system for core APIs (#134313) 2022-06-21 17:43:17 +02:00
discover [DOCS] Fix typo try-esql.asciidoc (#222735) 2025-06-05 07:25:51 +00:00
fleet [8.x] [Discover] Rename Saved Search to Discover Session (#202217) (#204818) 2024-12-19 21:38:57 +11:00
getting-started [8.x] [Docs] Update nav instructions and sample data installation to accommodate for the solution views (#199163) (#199438) 2024-11-08 10:41:00 +00:00
management [8.18] [DOCS] Microsoft Defender for Endpoint connector (#219999) (#220595) 2025-05-09 08:48:39 -04:00
maps [8.x] [Docs] Update certain references to cloud and ESS due to serverless GA (#202184) (#202202) 2024-11-28 16:23:22 +00:00
migration [DOCS] Remove breaking changes tags (#162928) 2023-08-02 08:27:22 -04:00
observability Remove APM documentation from Kibana repo and Guide (#179981) 2024-08-06 20:08:07 +00:00
osquery [8.18] [DOCS] Increase maximum Osquery timeout (#213918) (#214095) 2025-03-12 09:37:53 -04:00
reference/connectors-kibana [8.18] [DOCS] Microsoft Defender for Endpoint connector (#219999) (#220595) 2025-05-09 08:48:39 -04:00
search [8.18][DOCS] Backport - Update Inference UI (#213214) (#213351) 2025-03-06 13:53:43 +01:00
settings [8.18] Support local file path for xpack.productDocBase.artifactRepositoryUrl (#217046) (#224284) 2025-06-17 19:29:30 +02:00
setup [8.x] Update Reporting documentation: ES configuration, avoiding Token expiration (#208257) (#208717) 2025-01-29 11:25:58 +00:00
siem (Doc-) duplicate sections to SIEM docs (#188376) 2024-08-08 16:45:22 -04:00
spaces [8.x] Corrects the default max spaces in non-serverless docs (#203857) (#205982) 2025-01-09 00:59:51 +00:00
user [8.18] [DOCS] Deletes asciidoc Osquery API docs (#216269) (#216431) 2025-03-31 11:22:13 -04:00
accessibility.asciidoc
action-type-template.asciidoc [8.x] Backport: Sustainable Kibana Architecture: Move modules owned by @elastic/response-ops (#205166) 2024-12-26 21:47:26 +01:00
CHANGELOG.asciidoc [8.18] [Docs][8.18.2] Add known issue about kibana.yml file (#222212) (#222261) 2025-06-02 20:20:16 +00:00
gs-index.asciidoc [DOCS] Remove or move book-scoped attributes (#155210) 2023-04-20 09:12:09 -07:00
index.asciidoc [8.18] [Docs] Add page about Kibana's color modes (#215930) (#216010) 2025-03-27 10:04:35 +01:00
index.x.asciidoc
landing-page.asciidoc [8.x] [DOCS] Search landing page updates (#196131) (#196146) 2024-10-14 14:22:51 +00:00
limitations.asciidoc
migration.asciidoc
redirects.asciidoc [8.18] [DOCS] Remove Upgrade Assistant add default field API (#217264) (#217372) 2025-04-08 11:14:20 -04:00
rule-type-template.asciidoc [DOCS] Create and manage rule action frequencies (#150957) 2023-02-23 13:16:46 -08:00
template.asciidoc [DOCS] Remove snapshot and restore docs (#114836) 2021-11-16 16:59:24 -05:00
upgrade-notes.asciidoc [8.x] Add warnings to upgrade assistant for search sessions (#206998) (#208833) 2025-01-29 21:52:52 -04:00