kibana/docs/settings
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
..
images docs: APM spaces (#132071) 2022-06-02 15:06:00 -04:00
ai-assistant-settings.asciidoc [8.18] Support local file path for xpack.productDocBase.artifactRepositoryUrl (#217046) (#224284) 2025-06-17 19:29:30 +02:00
alert-action-settings.asciidoc [8.x] [DOCS] Remove inference connector docs (#198633) (#199846) 2024-11-12 13:56:59 -06:00
apm-settings.asciidoc Add otel datastream patterns to APM indices (#190533) 2024-08-22 04:07:24 -05:00
banners-settings.asciidoc [DOCS] Reformats the AleBanner settings tables into definition lists (#107966) 2021-08-20 10:03:51 -05:00
cases-settings.asciidoc [8.x] SKA: Update broken references and URLs (#206836) (#208479) 2025-01-28 10:09:09 +01:00
enterprise-search-settings.asciidoc [DOCS] Add settings for Enterprise Search (#126711) 2022-03-02 12:58:15 -08:00
fleet-settings.asciidoc [8.x] Update fleet-settings.asciidoc (#203194) (#206416) 2025-01-13 11:47:45 +00:00
general-infra-logs-ui-settings.asciidoc [8.x] Mark xpack.infra.sources.default.fields.message as deprecated in the docs (#208683) (#208892) 2025-01-30 10:06:35 +00:00
i18n-settings.asciidoc [i18n] a few docs updates (#127964) 2022-03-17 18:18:49 +02:00
infrastructure-ui-settings.asciidoc [DOCS] Edits titles in Setup section for consistency (#68451) 2020-06-08 14:46:26 -07:00
logging-settings.asciidoc [8.x] [HTTP] Log deprecated api usages (#207904) (#208548) 2025-01-28 17:10:52 +01:00
logs-ui-settings.asciidoc [DOC+] Move logging location reference (#158521) 2023-06-01 07:50:02 -06:00
monitoring-settings.asciidoc [Stack Monitoring] Add stale status reporting for Kibana (#132613) 2022-06-08 11:31:17 +02:00
reporting-settings.asciidoc [8.x] [Reporting/CSV/Docs] Specify maximum value for scroll.duration setting (#205765) (#205776) 2025-01-07 16:08:59 +00:00
search-sessions-settings.asciidoc Deprecate search session documentation (#192224) 2024-09-12 13:35:55 -07:00
security-settings.asciidoc [8.x] Fix documentation for session lifespan default (#198065) (#198070) 2024-10-28 18:31:25 +00:00
spaces-settings.asciidoc update monitoring.allowedSpaces documentation (#120362) 2021-12-07 12:04:07 +01:00
task-manager-settings.asciidoc [8.x] Update docs on task manager default poll interval as of 8.17 (#202559) (#202791) 2024-12-03 18:54:22 +00:00
telemetry-settings.asciidoc [8.x] [Docs] Add missing telemetry setting (#206403) (#206820) 2025-01-15 16:24:34 +00:00
url-drilldown-settings.asciidoc [DOCS] Reformats settings in drilldown doc (#120299) 2021-12-06 11:52:40 -08:00