From 7b32731b2556ca32ca837e4ff7850263719d7442 Mon Sep 17 00:00:00 2001
From: "docs-syncer[bot]" <134718678+docs-syncer[bot]@users.noreply.github.com>
Date: Thu, 12 Feb 2026 19:25:32 +0000
Subject: [PATCH] [flyctl-bot] Update docs from flyctl

---
 flyctl/cmd/fly_certs.md        |  1 +
 flyctl/cmd/fly_certs_import.md | 33 +++++++++++++++++++++++++++++++++
 flyctl/cmd/fly_certs_remove.md |  5 +++++
 3 files changed, 39 insertions(+)
 create mode 100644 flyctl/cmd/fly_certs_import.md

diff --git a/flyctl/cmd/fly_certs.md b/flyctl/cmd/fly_certs.md
index d06edd8aa4..a995589b8a 100644
--- a/flyctl/cmd/fly_certs.md
+++ b/flyctl/cmd/fly_certs.md
@@ -11,6 +11,7 @@ fly certs [command] [flags]
 ## Available Commands
 * [add](/docs/flyctl/certs-add/)	 - Add a certificate for an app
 * [check](/docs/flyctl/certs-check/)	 - Show certificate and DNS status
+* [import](/docs/flyctl/certs-import/)	 - Import a custom certificate
 * [list](/docs/flyctl/certs-list/)	 - List certificates for an app
 * [remove](/docs/flyctl/certs-remove/)	 - Removes a certificate from an app
 * [setup](/docs/flyctl/certs-setup/)	 - Shows certificate setup instructions
diff --git a/flyctl/cmd/fly_certs_import.md b/flyctl/cmd/fly_certs_import.md
new file mode 100644
index 0000000000..759e392cd4
--- /dev/null
+++ b/flyctl/cmd/fly_certs_import.md
@@ -0,0 +1,33 @@
+Import a custom TLS certificate for a hostname.
+
+Upload your own certificate and private key in PEM format. Requires domain
+ownership verification via DNS before the certificate becomes active.
+
+## Usage
+~~~
+fly certs import <hostname> [flags]
+~~~
+
+## Options
+
+~~~
+  -a, --app string           Application name
+  -c, --config string        Path to application configuration file
+      --fullchain string     Path to certificate chain file (PEM format)
+  -h, --help                 help for import
+  -j, --json                 JSON output
+      --private-key string   Path to private key file (PEM format)
+~~~
+
+## Global Options
+
+~~~
+  -t, --access-token string   Fly API Access Token
+      --debug                 Print additional logs and traces
+      --verbose               Verbose output
+~~~
+
+## See Also
+
+* [fly certs](/docs/flyctl/certs/)	 - Manage certificates
+
diff --git a/flyctl/cmd/fly_certs_remove.md b/flyctl/cmd/fly_certs_remove.md
index cfaf5dc747..8a750c5024 100644
--- a/flyctl/cmd/fly_certs_remove.md
+++ b/flyctl/cmd/fly_certs_remove.md
@@ -1,6 +1,9 @@
 Removes a certificate from an application. Takes hostname
 as a parameter to locate the certificate.
 
+Use --custom to remove only the custom certificate while keeping ACME certificates.
+Use --acme to stop ACME certificate issuance while keeping custom certificates.
+
 ## Usage
 ~~~
 fly certs remove <hostname> [flags]
@@ -9,8 +12,10 @@ fly certs remove <hostname> [flags]
 ## Options
 
 ~~~
+      --acme            Stop ACME certificate issuance, keeping custom certificates
   -a, --app string      Application name
   -c, --config string   Path to application configuration file
+      --custom          Remove only the custom certificate, keeping ACME certificates
   -h, --help            help for remove
   -y, --yes             Accept all confirmations
 ~~~