From e3ae286e2d6f65379aba76e4b17fa2d29239757c Mon Sep 17 00:00:00 2001 From: YaytayAtWork Date: Tue, 28 Jun 2022 14:00:45 +0100 Subject: [PATCH] docs: getting started notes on self-signed cert (#9429) (#9784) * Fix #9429: A couple of notes in the docs to explain that the default certificate is insecure. Signed-off-by: Jim Talbut * Fixes #9429: More verbose, but complete, text for Getting Started. Signed-off-by: Jim Talbut --- docs/faq.md | 4 +++- docs/getting_started.md | 6 ++++++ 2 files changed, 9 insertions(+), 1 deletion(-) diff --git a/docs/faq.md b/docs/faq.md index 85612570173f4..c0176354521f1 100644 --- a/docs/faq.md +++ b/docs/faq.md @@ -174,7 +174,9 @@ argocd ... --grpc-web ## Why Am I Getting `x509: certificate signed by unknown authority` When Using The CLI? -Your not running your server with correct certs. +The certificate created by default by Argo CD is not automatically recognised by the Argo CD CLI, in order +to create a secure system you must follow the instructions to [install a certificate](/operator-manual/tls/) +and configure your client OS to trust that certificate. If you're not running in a production system (e.g. you're testing Argo CD out), try the `--insecure` flag: diff --git a/docs/getting_started.md b/docs/getting_started.md index 65d611fb994dd..0eca3cbecf8be 100644 --- a/docs/getting_started.md +++ b/docs/getting_started.md @@ -29,6 +29,12 @@ kubectl create namespace argocd kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/core-install.yaml ``` +This default installation will have a self-signed certificate and cannot be accessed without a bit of extra work. +Do one of: +* Follow the [instructions to configure a certificate](./operator-manual/tls) (and ensure that the client OS trusts it). +* Configure the client OS to trust the self signed certificate. +* Use the --insecure flag on all Argo CD CLI operations in this guide. + Use `argocd login --core` to [configure](./user-guide/commands/argocd_login.md) CLI access and skip steps 3-5. ## 2. Download Argo CD CLI