Skip to content

Commit 57397be

Browse files
committed
Enhance Quick Start with comprehensive profile examples
Major improvement to Quick Start section with detailed examples: NEW SECTIONS: 📥 Download & Setup - Clean download instructions 🖥️ SERVER PROFILES - Shows behavior differences with package counts 📦 APPS PROFILES - Package selection with inheritance explanation 🔄 MIX & MATCH - Advanced combinations of server + apps profiles 🎯 SPECIFIC USE CASES - Real-world scenarios with exact commands IMPROVEMENTS: - Color-coded sections for visual clarity - Exact package counts for each profile - Concrete examples showing profile differences - Advanced usage patterns (mix & match) - Common use cases (VPS, containers, development) - Custom package management examples Users can now clearly see and understand: - Difference between server behavior vs package selection - How profiles inherit and combine - Specific commands for their exact needs
1 parent f9e0bd5 commit 57397be

1 file changed

Lines changed: 69 additions & 12 deletions

File tree

docs/index.html

Lines changed: 69 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -428,29 +428,86 @@ <h4 style="color: var(--accent); margin-bottom: 1rem;">🔄 Smart Mapping</h4>
428428
<h2 class="section-title">Deploy in one command.</h2>
429429
<p class="section-sub">Download the script, review it, run it with your preferred profile. No installer, no packages, no complex setup required.</p>
430430

431-
<div style="position: relative; margin: 2rem 0; border-radius: 8px; overflow: hidden;">
432-
<pre style="background: var(--bg2); border: 1px solid var(--border); padding: 1.5rem; font-family: var(--mono); font-size: 0.8rem; line-height: 1.6; overflow-x: auto; white-space: pre-wrap;"># Download and make executable
431+
<div style="margin: 2rem 0;">
432+
<!-- Download Section -->
433+
<div style="background: var(--bg2); border: 1px solid var(--border); border-radius: 8px; margin-bottom: 1.5rem; overflow: hidden;">
434+
<div style="background: var(--accent); color: white; padding: 0.5rem 1rem; font-weight: bold;">📥 Download & Setup</div>
435+
<pre style="padding: 1.5rem; margin: 0; font-family: var(--mono); font-size: 0.8rem; line-height: 1.6; overflow-x: auto;"># Download and make executable
433436
curl -O https://raw.githubusercontent.com/franckferman/debian-server-post-install/stable/debian-server-post-install.sh
434437
chmod +x debian-server-post-install.sh
435438

436-
# Review (important!)
437-
less debian-server-post-install.sh
439+
# Review before running (important!)
440+
less debian-server-post-install.sh</pre>
441+
</div>
438442

439-
# Basic installation (VPS-safe, no Docker)
443+
<!-- Basic Examples -->
444+
<div style="background: var(--bg2); border: 1px solid var(--border); border-radius: 8px; margin-bottom: 1.5rem; overflow: hidden;">
445+
<div style="background: #28a745; color: white; padding: 0.5rem 1rem; font-weight: bold;">🖥️ SERVER PROFILES (Behavior Configuration)</div>
446+
<pre style="padding: 1.5rem; margin: 0; font-family: var(--mono); font-size: 0.8rem; line-height: 1.6; overflow-x: auto;"># Default: Balanced server (UFW firewall, monitoring, 36 packages)
440447
./debian-server-post-install.sh
448+
./debian-server-post-install.sh --server-profile default
441449

442-
# Production with Docker
450+
# Production: nftables firewall + Docker enabled (36 packages)
443451
./debian-server-post-install.sh --server-profile prod
444452

445-
# Development stack
453+
# Development: Transparent firewall + full toolchain (57 packages)
446454
./debian-server-post-install.sh --server-profile dev
447455

448-
# Default + Docker installation
449-
./debian-server-post-install.sh --install-docker
450-
./debian-server-post-install.sh --docker-type ce
456+
# Minimal: Ultra-light, vim only (5 packages)
457+
./debian-server-post-install.sh --server-profile minimal
458+
459+
# Hardened: Maximum security + USBGuard (47 packages)
460+
./debian-server-post-install.sh --server-profile hardened</pre>
461+
</div>
462+
463+
<!-- Apps Profiles Examples -->
464+
<div style="background: var(--bg2); border: 1px solid var(--border); border-radius: 8px; margin-bottom: 1.5rem; overflow: hidden;">
465+
<div style="background: #6f42c1; color: white; padding: 0.5rem 1rem; font-weight: bold;">📦 APPS PROFILES (Package Selection)</div>
466+
<pre style="padding: 1.5rem; margin: 0; font-family: var(--mono); font-size: 0.8rem; line-height: 1.6; overflow-x: auto;"># Override default app profile selection
467+
./debian-server-post-install.sh --apps-profile minimal # 5 packages: survival only
468+
./debian-server-post-install.sh --apps-profile default # 29 packages: + infrastructure
469+
./debian-server-post-install.sh --apps-profile server # 36 packages: + server management
470+
./debian-server-post-install.sh --apps-profile enterprise # 60 packages: + backup-manager + compliance
471+
./debian-server-post-install.sh --apps-profile full # 57 packages: complete dev + security stack</pre>
472+
</div>
451473

452-
# For root users
453-
./debian-server-post-install.sh --allow-root</pre>
474+
<!-- Mix & Match Examples -->
475+
<div style="background: var(--bg2); border: 1px solid var(--border); border-radius: 8px; margin-bottom: 1.5rem; overflow: hidden;">
476+
<div style="background: #fd7e14; color: white; padding: 0.5rem 1rem; font-weight: bold;">🔄 MIX & MATCH (Server Config + Package Override)</div>
477+
<pre style="padding: 1.5rem; margin: 0; font-family: var(--mono); font-size: 0.8rem; line-height: 1.6; overflow-x: auto;"># Production server behavior BUT minimal packages
478+
./debian-server-post-install.sh --server-profile prod --apps-profile minimal
479+
480+
# Default server behavior BUT enterprise packages (with backup-manager)
481+
./debian-server-post-install.sh --server-profile default --apps-profile enterprise
482+
483+
# Development server BUT only essential packages
484+
./debian-server-post-install.sh --server-profile dev --apps-profile default
485+
486+
# Hardened security BUT full development stack
487+
./debian-server-post-install.sh --server-profile hardened --apps-profile full</pre>
488+
</div>
489+
490+
<!-- Specific Use Cases -->
491+
<div style="background: var(--bg2); border: 1px solid var(--border); border-radius: 8px; overflow: hidden;">
492+
<div style="background: #20c997; color: white; padding: 0.5rem 1rem; font-weight: bold;">🎯 SPECIFIC USE CASES</div>
493+
<pre style="padding: 1.5rem; margin: 0; font-family: var(--mono); font-size: 0.8rem; line-height: 1.6; overflow-x: auto;"># VPS with traditional backup needs
494+
./debian-server-post-install.sh --apps-profile enterprise
495+
496+
# Container host (no backup-manager needed)
497+
./debian-server-post-install.sh --apps-profile server
498+
499+
# Development workstation on server
500+
./debian-server-post-install.sh --server-profile dev
501+
502+
# Docker production server
503+
./debian-server-post-install.sh --server-profile prod --docker-type ce
504+
505+
# Add custom packages to any profile
506+
./debian-server-post-install.sh --extra-packages "htop,bat,fd-find"
507+
508+
# Remove specific packages from any profile
509+
./debian-server-post-install.sh --skip-apt-packages "backup-manager,screen"</pre>
510+
</div>
454511
</div>
455512
</div>
456513
</div>

0 commit comments

Comments
 (0)