Updating docs for mkcert

konstructio · Nov 26, 2024 · 5c8dd19 · 5c8dd19
1 parent de02729
commit 5c8dd19
Show file tree

Hide file tree

Showing 112 changed files with 4,949 additions and 168 deletions.
diff --git a/docs/akamai/quick-start/install/cli.mdx b/docs/akamai/quick-start/install/cli.mdx
@@ -38,6 +38,24 @@ export const TabLabel = ({ imgSrc, label, alt }) => (
 
     <TabItem attributes={{ className: styles.github }} value="github" label={ <GitHubLogo /> }>
     <GitHubPrerequisites />
+### Install the CA (Certificate Authority) of mkcert in your trusted store
+
+We use [mkcert](https://github.com/FiloSottile/mkcert) to generate local certificates and serve `https` with the Traefik Ingress Controller. During the installation, Kubefirst generates these certificates and pushes them to Kubernetes as secrets to attach to Ingress resources.
+
+To allow the applications running in your Kubefirst platform in addition to your browser to trust the certificates generated by your Kubefirst local install, you need to install the CA (Certificate Authority) of mkcert in your trusted store. To do so, follow these simple steps:
+
+```shell
+brew install mkcert
+mkcert -install
+```
+
+This is not an optional step: the cluster creation will fail if you don't install the mkcert CA in your trusted store.
+
+If you are using Firefox, you have one more step: you need to install the [Network Security Services](https://firefox-source-docs.mozilla.org/security/nss/index.html) (NSS):
+
+```shell
+brew install nss
+```
     <GitHubClusterCreateCmd />
     <CommonTerminalOutput cloud="Akamai"  minutes="10" handoffScreen={GitHubHandoffScreen} />
   </TabItem>

diff --git a/docs/aws/quick-start/install/cli.mdx b/docs/aws/quick-start/install/cli.mdx
@@ -37,11 +37,47 @@ export const TabLabel = ({ imgSrc, label, alt }) => (
 <Tabs groupId="git_provider" defaultValue="github" queryString>
   <TabItem attributes={{ className: styles.github }} value="github" label={ <GitHubLogo /> }>
     <GitHubPrerequisites />
+### Install the CA (Certificate Authority) of mkcert in your trusted store
+
+We use [mkcert](https://github.com/FiloSottile/mkcert) to generate local certificates and serve `https` with the Traefik Ingress Controller. During the installation, Kubefirst generates these certificates and pushes them to Kubernetes as secrets to attach to Ingress resources.
+
+To allow the applications running in your Kubefirst platform in addition to your browser to trust the certificates generated by your Kubefirst local install, you need to install the CA (Certificate Authority) of mkcert in your trusted store. To do so, follow these simple steps:
+
+```shell
+brew install mkcert
+mkcert -install
+```
+
+This is not an optional step: the cluster creation will fail if you don't install the mkcert CA in your trusted store.
+
+If you are using Firefox, you have one more step: you need to install the [Network Security Services](https://firefox-source-docs.mozilla.org/security/nss/index.html) (NSS):
+
+```shell
+brew install nss
+```
     <GitHubClusterCreateCmd />
     <CommonTerminalOutput cloud="Aws"  minutes="10" handoffScreen={GitHubHandoffScreen} />
   </TabItem>
   <TabItem attributes={{ className: styles.gitlab }} value="gitlab" label={ <GitLabLogo /> }>
     <GitLabPrerequisites />
+### Install the CA (Certificate Authority) of mkcert in your trusted store
+
+We use [mkcert](https://github.com/FiloSottile/mkcert) to generate local certificates and serve `https` with the Traefik Ingress Controller. During the installation, Kubefirst generates these certificates and pushes them to Kubernetes as secrets to attach to Ingress resources.
+
+To allow the applications running in your Kubefirst platform in addition to your browser to trust the certificates generated by your Kubefirst local install, you need to install the CA (Certificate Authority) of mkcert in your trusted store. To do so, follow these simple steps:
+
+```shell
+brew install mkcert
+mkcert -install
+```
+
+This is not an optional step: the cluster creation will fail if you don't install the mkcert CA in your trusted store.
+
+If you are using Firefox, you have one more step: you need to install the [Network Security Services](https://firefox-source-docs.mozilla.org/security/nss/index.html) (NSS):
+
+```shell
+brew install nss
+```
     <GitLabClusterCreateCmd />
     <CommonTerminalOutput cloud="Aws"  minutes="10" handoffScreen={GitLabHandoffScreen} />
   </TabItem>

diff --git a/docs/azure/quick-start/install/cli.mdx b/docs/azure/quick-start/install/cli.mdx
@@ -27,12 +27,48 @@ import GitLabHandoffScreen from "../../../img/azure/gitlab/handoff-screen.png";
 
     <TabItem attributes={{ className: styles.github }} value="github" label={ <GitHubLogo /> }>
         <GitHubPrerequisites />
+### Install the CA (Certificate Authority) of mkcert in your trusted store
+
+We use [mkcert](https://github.com/FiloSottile/mkcert) to generate local certificates and serve `https` with the Traefik Ingress Controller. During the installation, Kubefirst generates these certificates and pushes them to Kubernetes as secrets to attach to Ingress resources.
+
+To allow the applications running in your Kubefirst platform in addition to your browser to trust the certificates generated by your Kubefirst local install, you need to install the CA (Certificate Authority) of mkcert in your trusted store. To do so, follow these simple steps:
+
+```shell
+brew install mkcert
+mkcert -install
+```
+
+This is not an optional step: the cluster creation will fail if you don't install the mkcert CA in your trusted store.
+
+If you are using Firefox, you have one more step: you need to install the [Network Security Services](https://firefox-source-docs.mozilla.org/security/nss/index.html) (NSS):
+
+```shell
+brew install nss
+```
         <GitHubClusterCreateCmd />
         <CommonTerminalOutput cloud="Azure"  minutes="20" handoffScreen={GitHubHandoffScreen} />
     </TabItem>
 
     <TabItem attributes={{ className: styles.gitlab }} value="gitlab" label={ <GitLabLogo /> }>
         <GitLabPrerequisites />
+### Install the CA (Certificate Authority) of mkcert in your trusted store
+
+We use [mkcert](https://github.com/FiloSottile/mkcert) to generate local certificates and serve `https` with the Traefik Ingress Controller. During the installation, Kubefirst generates these certificates and pushes them to Kubernetes as secrets to attach to Ingress resources.
+
+To allow the applications running in your Kubefirst platform in addition to your browser to trust the certificates generated by your Kubefirst local install, you need to install the CA (Certificate Authority) of mkcert in your trusted store. To do so, follow these simple steps:
+
+```shell
+brew install mkcert
+mkcert -install
+```
+
+This is not an optional step: the cluster creation will fail if you don't install the mkcert CA in your trusted store.
+
+If you are using Firefox, you have one more step: you need to install the [Network Security Services](https://firefox-source-docs.mozilla.org/security/nss/index.html) (NSS):
+
+```shell
+brew install nss
+```
         <GitLabClusterCreateCmd />
         <CommonTerminalOutput cloud="Azure"  minutes="20" handoffScreen={GitLabHandoffScreen} />
     </TabItem>

diff --git a/docs/civo/quick-start/install/cli.mdx b/docs/civo/quick-start/install/cli.mdx
@@ -38,12 +38,50 @@ export const TabLabel = ({ imgSrc, label, alt }) => (
 
     <TabItem attributes={{ className: styles.github }} value="github" label={ <GitHubLogo /> }>
     <GitHubPrerequisites />
+
+### Install the CA (Certificate Authority) of mkcert in your trusted store
+
+We use [mkcert](https://github.com/FiloSottile/mkcert) to generate local certificates and serve `https` with the Traefik Ingress Controller. During the installation, Kubefirst generates these certificates and pushes them to Kubernetes as secrets to attach to Ingress resources.
+
+To allow the applications running in your Kubefirst platform in addition to your browser to trust the certificates generated by your Kubefirst local install, you need to install the CA (Certificate Authority) of mkcert in your trusted store. To do so, follow these simple steps:
+
+```shell
+brew install mkcert
+mkcert -install
+```
+
+This is not an optional step: the cluster creation will fail if you don't install the mkcert CA in your trusted store.
+
+If you are using Firefox, you have one more step: you need to install the [Network Security Services](https://firefox-source-docs.mozilla.org/security/nss/index.html) (NSS):
+
+```shell
+brew install nss
+```
+
     <GitHubClusterCreateCmd />
     <CommonTerminalOutput cloud="Civo"  minutes="10" handoffScreen={GitHubHandoffScreen} />
   </TabItem>
 
       <TabItem attributes={{ className: styles.gitlab }} value="gitlab" label={ <GitLabLogo /> }>
     <GitLabPrerequisites />
+### Install the CA (Certificate Authority) of mkcert in your trusted store
+
+We use [mkcert](https://github.com/FiloSottile/mkcert) to generate local certificates and serve `https` with the Traefik Ingress Controller. During the installation, Kubefirst generates these certificates and pushes them to Kubernetes as secrets to attach to Ingress resources.
+
+To allow the applications running in your Kubefirst platform in addition to your browser to trust the certificates generated by your Kubefirst local install, you need to install the CA (Certificate Authority) of mkcert in your trusted store. To do so, follow these simple steps:
+
+```shell
+brew install mkcert
+mkcert -install
+```
+
+This is not an optional step: the cluster creation will fail if you don't install the mkcert CA in your trusted store.
+
+If you are using Firefox, you have one more step: you need to install the [Network Security Services](https://firefox-source-docs.mozilla.org/security/nss/index.html) (NSS):
+
+```shell
+brew install nss
+```
     <GitLabClusterCreateCmd />
     <CommonTerminalOutput cloud="Civo"  minutes="10" handoffScreen={GitLabHandoffScreen} />
   </TabItem>

diff --git a/docs/do/quick-start/install/cli.mdx b/docs/do/quick-start/install/cli.mdx
@@ -39,13 +39,49 @@ export const TabLabel = ({ imgSrc, label, alt }) => (
 
     <TabItem attributes={{ className: styles.github }} value="github" label={<GitHubLogo /> }>
     <GitHubPrerequisites />
+### Install the CA (Certificate Authority) of mkcert in your trusted store
+
+We use [mkcert](https://github.com/FiloSottile/mkcert) to generate local certificates and serve `https` with the Traefik Ingress Controller. During the installation, Kubefirst generates these certificates and pushes them to Kubernetes as secrets to attach to Ingress resources.
+
+To allow the applications running in your Kubefirst platform in addition to your browser to trust the certificates generated by your Kubefirst local install, you need to install the CA (Certificate Authority) of mkcert in your trusted store. To do so, follow these simple steps:
+
+```shell
+brew install mkcert
+mkcert -install
+```
+
+This is not an optional step: the cluster creation will fail if you don't install the mkcert CA in your trusted store.
+
+If you are using Firefox, you have one more step: you need to install the [Network Security Services](https://firefox-source-docs.mozilla.org/security/nss/index.html) (NSS):
+
+```shell
+brew install nss
+```
     <GitHubClusterCreateCmd />
     <SpaceRegion />
     <CommonTerminalOutput cloud="Do"  minutes="10" handoffScreen={GitHubHandoffScreen} />
   </TabItem>
 
       <TabItem attributes={{ className: styles.gitlab }} value="gitlab" label={ <GitLabLogo /> }>
     <GitLabPrerequisites />
+### Install the CA (Certificate Authority) of mkcert in your trusted store
+
+We use [mkcert](https://github.com/FiloSottile/mkcert) to generate local certificates and serve `https` with the Traefik Ingress Controller. During the installation, Kubefirst generates these certificates and pushes them to Kubernetes as secrets to attach to Ingress resources.
+
+To allow the applications running in your Kubefirst platform in addition to your browser to trust the certificates generated by your Kubefirst local install, you need to install the CA (Certificate Authority) of mkcert in your trusted store. To do so, follow these simple steps:
+
+```shell
+brew install mkcert
+mkcert -install
+```
+
+This is not an optional step: the cluster creation will fail if you don't install the mkcert CA in your trusted store.
+
+If you are using Firefox, you have one more step: you need to install the [Network Security Services](https://firefox-source-docs.mozilla.org/security/nss/index.html) (NSS):
+
+```shell
+brew install nss
+```
     <GitLabClusterCreateCmd />
     <SpaceRegion />
     <CommonTerminalOutput cloud="Do"  minutes="10" handoffScreen={GitLabHandoffScreen} />

diff --git a/docs/gcp/quick-start/install/cli.mdx b/docs/gcp/quick-start/install/cli.mdx
@@ -38,12 +38,48 @@ export const TabLabel = ({ imgSrc, label, alt }) => (
 
     <TabItem attributes={{ className: styles.github }} value="github" label={ <GitHubLogo /> }>
     <GitHubPrerequisites />
+### Install the CA (Certificate Authority) of mkcert in your trusted store
+
+We use [mkcert](https://github.com/FiloSottile/mkcert) to generate local certificates and serve `https` with the Traefik Ingress Controller. During the installation, Kubefirst generates these certificates and pushes them to Kubernetes as secrets to attach to Ingress resources.
+
+To allow the applications running in your Kubefirst platform in addition to your browser to trust the certificates generated by your Kubefirst local install, you need to install the CA (Certificate Authority) of mkcert in your trusted store. To do so, follow these simple steps:
+
+```shell
+brew install mkcert
+mkcert -install
+```
+
+This is not an optional step: the cluster creation will fail if you don't install the mkcert CA in your trusted store.
+
+If you are using Firefox, you have one more step: you need to install the [Network Security Services](https://firefox-source-docs.mozilla.org/security/nss/index.html) (NSS):
+
+```shell
+brew install nss
+```
     <GitHubClusterCreateCmd />
     <CommonTerminalOutput cloud="Gcp"  minutes="10" handoffScreen={GitHubHandoffScreen} />
   </TabItem>
 
       <TabItem attributes={{ className: styles.gitlab }} value="gitlab" label={ <GitLabLogo /> }>
     <GitLabPrerequisites />
+### Install the CA (Certificate Authority) of mkcert in your trusted store
+
+We use [mkcert](https://github.com/FiloSottile/mkcert) to generate local certificates and serve `https` with the Traefik Ingress Controller. During the installation, Kubefirst generates these certificates and pushes them to Kubernetes as secrets to attach to Ingress resources.
+
+To allow the applications running in your Kubefirst platform in addition to your browser to trust the certificates generated by your Kubefirst local install, you need to install the CA (Certificate Authority) of mkcert in your trusted store. To do so, follow these simple steps:
+
+```shell
+brew install mkcert
+mkcert -install
+```
+
+This is not an optional step: the cluster creation will fail if you don't install the mkcert CA in your trusted store.
+
+If you are using Firefox, you have one more step: you need to install the [Network Security Services](https://firefox-source-docs.mozilla.org/security/nss/index.html) (NSS):
+
+```shell
+brew install nss
+```
     <GitLabClusterCreateCmd />
     <CommonTerminalOutput cloud="Gcp"  minutes="10" handoffScreen={GitLabHandoffScreen} />
   </TabItem>

diff --git a/docs/k3s/quick-start/install/cli.mdx b/docs/k3s/quick-start/install/cli.mdx
@@ -37,11 +37,47 @@ export const TabLabel = ({ imgSrc, label, alt }) => (
 <Tabs groupId="git_provider" defaultValue="gitlab" queryString>
   <TabItem attributes={{ className: styles.github }} value="github" label={ <GitHubLogo /> }>
     <GitHubPrerequisites />
+### Install the CA (Certificate Authority) of mkcert in your trusted store
+
+We use [mkcert](https://github.com/FiloSottile/mkcert) to generate local certificates and serve `https` with the Traefik Ingress Controller. During the installation, Kubefirst generates these certificates and pushes them to Kubernetes as secrets to attach to Ingress resources.
+
+To allow the applications running in your Kubefirst platform in addition to your browser to trust the certificates generated by your Kubefirst local install, you need to install the CA (Certificate Authority) of mkcert in your trusted store. To do so, follow these simple steps:
+
+```shell
+brew install mkcert
+mkcert -install
+```
+
+This is not an optional step: the cluster creation will fail if you don't install the mkcert CA in your trusted store.
+
+If you are using Firefox, you have one more step: you need to install the [Network Security Services](https://firefox-source-docs.mozilla.org/security/nss/index.html) (NSS):
+
+```shell
+brew install nss
+```
     <GitHubClusterCreateCmd />
     <CommonTerminalOutput cloud="K3s"  minutes="10" handoffScreen={GitHubHandoffScreen} />
   </TabItem>
   <TabItem attributes={{ className: styles.gitlab }} value="gitlab" label={ <GitLabLogo /> }>
     <GitLabPrerequisites />
+### Install the CA (Certificate Authority) of mkcert in your trusted store
+
+We use [mkcert](https://github.com/FiloSottile/mkcert) to generate local certificates and serve `https` with the Traefik Ingress Controller. During the installation, Kubefirst generates these certificates and pushes them to Kubernetes as secrets to attach to Ingress resources.
+
+To allow the applications running in your Kubefirst platform in addition to your browser to trust the certificates generated by your Kubefirst local install, you need to install the CA (Certificate Authority) of mkcert in your trusted store. To do so, follow these simple steps:
+
+```shell
+brew install mkcert
+mkcert -install
+```
+
+This is not an optional step: the cluster creation will fail if you don't install the mkcert CA in your trusted store.
+
+If you are using Firefox, you have one more step: you need to install the [Network Security Services](https://firefox-source-docs.mozilla.org/security/nss/index.html) (NSS):
+
+```shell
+brew install nss
+```
     <GitLabClusterCreateCmd />
     <CommonTerminalOutput cloud="K3s"  minutes="10" handoffScreen={GitLabHandoffScreen} />
   </TabItem>

diff --git a/docs/vultr/quick-start/install/cli.mdx b/docs/vultr/quick-start/install/cli.mdx
@@ -38,12 +38,48 @@ export const TabLabel = ({ imgSrc, label, alt }) => (
 
     <TabItem attributes={{ className: styles.github }} value="github" label={ <GitHubLogo /> }>
     <GitHubPrerequisites />
+### Install the CA (Certificate Authority) of mkcert in your trusted store
+
+We use [mkcert](https://github.com/FiloSottile/mkcert) to generate local certificates and serve `https` with the Traefik Ingress Controller. During the installation, Kubefirst generates these certificates and pushes them to Kubernetes as secrets to attach to Ingress resources.
+
+To allow the applications running in your Kubefirst platform in addition to your browser to trust the certificates generated by your Kubefirst local install, you need to install the CA (Certificate Authority) of mkcert in your trusted store. To do so, follow these simple steps:
+
+```shell
+brew install mkcert
+mkcert -install
+```
+
+This is not an optional step: the cluster creation will fail if you don't install the mkcert CA in your trusted store.
+
+If you are using Firefox, you have one more step: you need to install the [Network Security Services](https://firefox-source-docs.mozilla.org/security/nss/index.html) (NSS):
+
+```shell
+brew install nss
+```
     <GitHubClusterCreateCmd />
     <CommonTerminalOutput cloud="Vultr"  minutes="10" handoffScreen={GitHubHandoffScreen} />
   </TabItem>
 
       <TabItem attributes={{ className: styles.gitlab }} value="gitlab" label={ <GitLabLogo /> }>
     <GitLabPrerequisites />
+### Install the CA (Certificate Authority) of mkcert in your trusted store
+
+We use [mkcert](https://github.com/FiloSottile/mkcert) to generate local certificates and serve `https` with the Traefik Ingress Controller. During the installation, Kubefirst generates these certificates and pushes them to Kubernetes as secrets to attach to Ingress resources.
+
+To allow the applications running in your Kubefirst platform in addition to your browser to trust the certificates generated by your Kubefirst local install, you need to install the CA (Certificate Authority) of mkcert in your trusted store. To do so, follow these simple steps:
+
+```shell
+brew install mkcert
+mkcert -install
+```
+
+This is not an optional step: the cluster creation will fail if you don't install the mkcert CA in your trusted store.
+
+If you are using Firefox, you have one more step: you need to install the [Network Security Services](https://firefox-source-docs.mozilla.org/security/nss/index.html) (NSS):
+
+```shell
+brew install nss
+```
     <GitLabClusterCreateCmd />
     <CommonTerminalOutput cloud="Vultr"  minutes="10" handoffScreen={GitLabHandoffScreen} />
   </TabItem>

diff --git a/versioned_docs/version-2.7/akamai/partials/common/_installed-applications.mdx b/versioned_docs/version-2.7/akamai/partials/common/_installed-applications.mdx
@@ -1,3 +1,3 @@
 ### Installed Applications
 
-To see what is installed by kubefirst, check the [overview page](../../overview.mdx).
+To see what is installed by Kubefirst, check the [overview page](../../overview.mdx).