From 4108bef9c38ae7b0852fef02e9cadec12cffcf3d Mon Sep 17 00:00:00 2001 From: Cody Rester Date: Wed, 2 Sep 2026 10:37:07 -0500 Subject: [PATCH 1/2] docs: use INI format in README Quick Start config example The default config auto-discovery path (no --config/IPCTL_CONFIG set) hardcodes the Viper config type to "ini", so a ~/.platform.d/config.toml found via auto-discovery is actually parsed with the INI decoder, not the TOML decoder. TOML-style quoted section headers like ["profile default"] get mangled by the INI parser, silently dropping the profile. Switch the Quick Start example to plain INI syntax so it matches what auto-discovery actually parses. Co-Authored-By: Claude Sonnet 5 --- README.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index 4f7533f0..e5bbdc7c 100644 --- a/README.md +++ b/README.md @@ -30,15 +30,15 @@ make build ### Configure -Create `~/.platform.d/config.toml` with a server profile: +Create `~/.platform.d/config.ini` with a server profile: -```toml -["profile default"] -host = "platform.example.com" +```ini +[profile default] +host = platform.example.com port = 443 use_tls = true -username = "admin" -password = "your-password" +username = admin +password = your-password ``` ### Use From e5a0f62325267731f768739eba7eaf1ef24670d7 Mon Sep 17 00:00:00 2001 From: Cody Rester Date: Wed, 2 Sep 2026 10:44:33 -0500 Subject: [PATCH 2/2] docs: show default_profile and explicit verify in README config example Naming a profile (e.g. "local") in config.ini isn't enough to make it active - without --profile or an [application] default_profile setting, ipctl silently falls back to its built-in empty default profile (port 0, resolved to 443). Show the [application] default_profile setting so the Quick Start example actually works without extra flags, and make the verify option explicit since it directly affects whether self-signed/local TLS certs are trusted. Co-Authored-By: Claude Sonnet 5 --- README.md | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index e5bbdc7c..733902b3 100644 --- a/README.md +++ b/README.md @@ -30,13 +30,18 @@ make build ### Configure -Create `~/.platform.d/config.ini` with a server profile: +Create `~/.platform.d/config.ini` with a server profile, and set it as the +default profile so it's used automatically without passing `--profile`: ```ini -[profile default] +[application] +default_profile = local + +[profile local] host = platform.example.com port = 443 use_tls = true +verify = true username = admin password = your-password ```