From 497532ee487a3d0963585be1db7621a5c7d20e58 Mon Sep 17 00:00:00 2001 From: mikisoq Date: Wed, 29 Jul 2026 02:04:47 -0100 Subject: [PATCH] Restructure README: features, per-platform prereqs, then install --- README.md | 26 ++++++++++++-------------- 1 file changed, 12 insertions(+), 14 deletions(-) diff --git a/README.md b/README.md index 8152958..bd5ac37 100644 --- a/README.md +++ b/README.md @@ -2,6 +2,15 @@ Cross-platform Avalonia UI app for bulk Active Directory operations from a CSV file. +## Features + +- Load a CSV with any column structure +- Auto-discover the AD domain and domain controller via DNS (click **Discover** or runs on startup) +- Built-in port/connectivity health check (DNS, TCP 389, TCP 636, LDAP bind, LDAPS bind) +- Dry-run mode to validate before making changes +- Actions: enable, disable, add/remove from group, set/force password change +- LDAP 389 for normal edits; LDAPS 636 required for password resets + ## Prerequisites - [.NET 8 SDK](https://dotnet.microsoft.com/download/dotnet/8.0) @@ -31,7 +40,7 @@ sudo apt install dotnet-sdk-8.0 brew install dotnet-sdk-8.0 ``` -## Build & Run +## Install & Run ```bash git clone https://gitea.mikisoq.cc/mikisoq/ADBulk.git @@ -43,15 +52,6 @@ dotnet run On Windows, you can also open the folder in Visual Studio and run from there. -## Features - -- Load a CSV with any column structure -- Auto-discover the AD domain and domain controller via DNS (click **Discover** or runs on startup) -- Supports LDAP 389 (normal edits) and LDAPS 636 (password resets) -- Built-in port/connectivity health check -- Dry-run mode to validate before making changes -- Actions: enable, disable, add/remove from group, set/force password change - ## Quick start 1. Launch the app @@ -73,14 +73,12 @@ On Windows, you can also open the folder in Visual Studio and run from there. ### Linux -Place your root CA certificate and run: - ```bash -# Arch / CachyOS +# Arch / CachyOS — place root CA and run: sudo cp your-root-ca.crt /etc/ca-certificates/trust-source/anchors/ sudo trust extract-compat -# Ubuntu / Debian +# Ubuntu / Debian: sudo cp your-root-ca.crt /usr/local/share/ca-certificates/ sudo update-ca-certificates ```