Restructure README: features, per-platform prereqs, then install

This commit is contained in:
mikisoq
2026-07-29 02:04:47 -01:00
parent bb32a78e1e
commit 31d1526ffe
+12 -14
View File
@@ -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
```