From 5fcc8581b2aeb0cc5ba0512939b139bd0b02432e Mon Sep 17 00:00:00 2001 From: Roman Dmytrenko Date: Wed, 21 Jan 2026 13:17:45 +0000 Subject: [PATCH 1/2] docs: add known_hosts container deployment warning to storage config fixes #383 Signed-off-by: Roman Dmytrenko --- docs/v1/configuration/storage.mdx | 14 +++++++++++--- docs/v2/cli/commands/license/activate.mdx | 2 +- docs/v2/cli/commands/license/check.mdx | 2 +- docs/v2/configuration/storage.mdx | 8 ++++++++ 4 files changed, 21 insertions(+), 5 deletions(-) diff --git a/docs/v1/configuration/storage.mdx b/docs/v1/configuration/storage.mdx index 9320f68..9d6cb6a 100644 --- a/docs/v1/configuration/storage.mdx +++ b/docs/v1/configuration/storage.mdx @@ -353,6 +353,14 @@ storage: `false` by default. Instead, you are advised to put the key fingerprint in the known hosts file where you are running Flipt. For example, for GitHub you can do `ssh-keyscan github.com >> ~/.ssh/known_hosts` on the Flipt host. + +_Container Deployment_: When running Flipt in containers, mount the known_hosts file to the system-wide SSH path instead of a user directory. For example, with Docker + +```yaml +volumes: + - /path/to/your/known_hosts:/etc/ssh/ssh_known_hosts:ro +``` + See our [GitOps Guide](/v1/guides/user/get-going-with-gitops) for an example of how to set up a GitHub repository as a flag state backend. @@ -494,9 +502,9 @@ These should be provided as environment variables to the Flipt server process. T - Using [Azure Credentials](https://learn.microsoft.com/en-us/azure/developer/go/azure-sdk-authentication?tabs=bash#2-authenticate-with-azure) ```bash -AZURE_CLIENT_ID=... # application ID of an Azure service principal -AZURE_TENANT_ID=... # ID of the application's Microsoft Entra tenant -AZURE_CLIENT_SECRET=... # password of the Azure service principal +AZURE_CLIENT_ID=... # application ID of an Azure service principal +AZURE_TENANT_ID=... # ID of the application's Microsoft Entra tenant +AZURE_CLIENT_SECRET=... # password of the Azure service principal ``` - Using Azure Blob [Storage Account Keys](https://learn.microsoft.com/en-us/azure/storage/common/storage-account-keys-manage?tabs=azure-portal) diff --git a/docs/v2/cli/commands/license/activate.mdx b/docs/v2/cli/commands/license/activate.mdx index 13a88ac..29ccf51 100644 --- a/docs/v2/cli/commands/license/activate.mdx +++ b/docs/v2/cli/commands/license/activate.mdx @@ -35,7 +35,7 @@ flipt license activate flipt license activate --config /path/to/config.yml ``` - +{/-- TODO: Add screenshot of license activation wizard --/} ## More Info diff --git a/docs/v2/cli/commands/license/check.mdx b/docs/v2/cli/commands/license/check.mdx index 840e184..7025121 100644 --- a/docs/v2/cli/commands/license/check.mdx +++ b/docs/v2/cli/commands/license/check.mdx @@ -35,7 +35,7 @@ flipt license check flipt license check --config /path/to/config.yml ``` - +{/-- TODO: Add screenshot of license check command output --/} ## More Info diff --git a/docs/v2/configuration/storage.mdx b/docs/v2/configuration/storage.mdx index 3ed9de4..e21e170 100644 --- a/docs/v2/configuration/storage.mdx +++ b/docs/v2/configuration/storage.mdx @@ -197,6 +197,14 @@ credentials: `false` by default. Instead, you are advised to put the key fingerprint in the known hosts file where you are running Flipt. For example, for GitHub you can do `ssh-keyscan github.com >> ~/.ssh/known_hosts` on the Flipt host. + +_Container Deployment_: When running Flipt in containers, mount the known_hosts file to the system-wide SSH path instead of a user directory. For example, with Docker + +```yaml +volumes: + - /path/to/your/known_hosts:/etc/ssh/ssh_known_hosts:ro +``` + #### Access Token From 3038352932d4d7053a1f8045e39a37a70a7e8f3d Mon Sep 17 00:00:00 2001 From: Roman Dmytrenko Date: Wed, 21 Jan 2026 16:58:18 +0000 Subject: [PATCH 2/2] address PR feedback Signed-off-by: Roman Dmytrenko --- docs/v2/cli/commands/license/activate.mdx | 2 +- docs/v2/cli/commands/license/check.mdx | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/v2/cli/commands/license/activate.mdx b/docs/v2/cli/commands/license/activate.mdx index 29ccf51..da01cd2 100644 --- a/docs/v2/cli/commands/license/activate.mdx +++ b/docs/v2/cli/commands/license/activate.mdx @@ -35,7 +35,7 @@ flipt license activate flipt license activate --config /path/to/config.yml ``` -{/-- TODO: Add screenshot of license activation wizard --/} +{/* TODO: Add screenshot of license activation wizard */} ## More Info diff --git a/docs/v2/cli/commands/license/check.mdx b/docs/v2/cli/commands/license/check.mdx index 7025121..a13d05c 100644 --- a/docs/v2/cli/commands/license/check.mdx +++ b/docs/v2/cli/commands/license/check.mdx @@ -35,7 +35,7 @@ flipt license check flipt license check --config /path/to/config.yml ``` -{/-- TODO: Add screenshot of license check command output --/} +{/* TODO: Add screenshot of license check command output */} ## More Info