Skip to content

Commit 0a106b2

Browse files
author
bad-antics
committed
docs: Add comprehensive wiki documentation
- Home page with quick start guide - Installation guide for all platforms (USB, VM, Docker, WSL) - Editions overview (Standard, Lite, Cloud, Auto, AI/ML, Hardware) - Complete tools reference (135+ tools)
1 parent e1d377f commit 0a106b2

4 files changed

Lines changed: 963 additions & 0 deletions

File tree

‎docs/Editions.md‎

Lines changed: 264 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,264 @@
1+
# 📦 NullSec Linux Editions
2+
3+
NullSec Linux is available in multiple editions, each tailored for specific security testing scenarios.
4+
5+
---
6+
7+
## Standard Edition
8+
9+
**Target Audience:** General penetration testers, security researchers
10+
11+
### Features
12+
- 135+ pre-installed security tools
13+
- Full desktop environment (XFCE)
14+
- NullSec Tools suite
15+
- Marshall Browser
16+
- Common wordlists
17+
18+
### Included Tool Categories
19+
- Web application testing
20+
- Network scanning
21+
- Password attacks
22+
- Exploitation frameworks
23+
- Forensics tools
24+
- Reverse engineering
25+
- Wireless testing
26+
- OSINT tools
27+
28+
### System Requirements
29+
| Spec | Minimum | Recommended |
30+
|------|---------|-------------|
31+
| RAM | 4GB | 8GB+ |
32+
| Disk | 25GB | 50GB+ |
33+
| CPU | 2 cores | 4+ cores |
34+
35+
---
36+
37+
## Lite Edition
38+
39+
**Target Audience:** Low-resource systems, Raspberry Pi, older hardware
40+
41+
### Features
42+
- Core security tools only (~50 tools)
43+
- Lightweight XFCE desktop
44+
- Optimized for 2GB RAM systems
45+
- Smaller ISO size (~2GB)
46+
47+
### Included Tools
48+
- Nmap, Masscan
49+
- SQLMap, Nikto
50+
- John the Ripper
51+
- Aircrack-ng
52+
- Netcat, Socat
53+
- Basic NullSec Tools
54+
55+
### System Requirements
56+
| Spec | Minimum | Recommended |
57+
|------|---------|-------------|
58+
| RAM | 2GB | 4GB |
59+
| Disk | 15GB | 25GB |
60+
| CPU | 1 core | 2+ cores |
61+
62+
### Supported Platforms
63+
- x86_64
64+
- Raspberry Pi 4/5 (ARM64)
65+
- Virtual machines with limited resources
66+
67+
---
68+
69+
## Cloud Edition
70+
71+
**Target Audience:** Cloud security testers, DevSecOps
72+
73+
### Features
74+
- Cloud provider CLI tools pre-installed
75+
- Kubernetes security tools
76+
- Container security tools
77+
- Terraform security scanners
78+
- Serverless testing tools
79+
80+
### Included Cloud Tools
81+
| Provider | Tools |
82+
|----------|-------|
83+
| **AWS** | aws-cli, Pacu, Prowler, ScoutSuite |
84+
| **Azure** | az-cli, AzureHound, MicroBurst |
85+
| **GCP** | gcloud, GCPBucketBrute |
86+
| **General** | CloudSploit, cloud-enum |
87+
88+
### Kubernetes Tools
89+
- kubectl, kube-hunter
90+
- kubesec, trivy
91+
- kube-bench, falco
92+
- kube-score
93+
94+
### Container Tools
95+
- Docker, Podman
96+
- Dive (image analyzer)
97+
- Clair, Anchore
98+
- Container escape tools
99+
100+
### System Requirements
101+
| Spec | Minimum | Recommended |
102+
|------|---------|-------------|
103+
| RAM | 4GB | 8GB+ |
104+
| Disk | 30GB | 50GB+ |
105+
| CPU | 2 cores | 4+ cores |
106+
| Network | Fast internet | Fast internet |
107+
108+
---
109+
110+
## Automotive Edition
111+
112+
**Target Audience:** Automotive security researchers, vehicle pentesters
113+
114+
### Features
115+
- CAN bus tools
116+
- ECU testing tools
117+
- OBD-II interfaces
118+
- Vehicle protocol analyzers
119+
- Diagnostic tools
120+
121+
### Included Automotive Tools
122+
| Category | Tools |
123+
|----------|-------|
124+
| **CAN Bus** | can-utils, SavvyCAN, CANalyzer |
125+
| **Diagnostics** | OBD-II readers, UDS tools |
126+
| **ECU** | BlackFlag ECU, OpenGarage |
127+
| **Analysis** | Kayak, ICSim, Caringorm |
128+
| **Hardware** | ChipWhisperer support, J2534 |
129+
130+
### Hardware Support
131+
- SocketCAN interfaces
132+
- Peak CAN adapters
133+
- Vector CAN interfaces
134+
- ELM327 OBD-II adapters
135+
- Macchina M2
136+
137+
### System Requirements
138+
| Spec | Minimum | Recommended |
139+
|------|---------|-------------|
140+
| RAM | 4GB | 8GB+ |
141+
| Disk | 25GB | 50GB+ |
142+
| USB | 2.0+ | 3.0+ |
143+
| CAN | Optional | Required for full testing |
144+
145+
---
146+
147+
## AI/ML Security Edition
148+
149+
**Target Audience:** AI/ML security researchers, adversarial ML testers
150+
151+
### Features
152+
- Adversarial machine learning tools
153+
- Model extraction tools
154+
- Data poisoning frameworks
155+
- ML pipeline security testing
156+
- LLM security tools
157+
158+
### Included AI/ML Tools
159+
| Category | Tools |
160+
|----------|-------|
161+
| **Adversarial** | CleverHans, ART, Foolbox |
162+
| **Evasion** | TextFooler, DeepXplore |
163+
| **Extraction** | ModelLeaks, PRADA |
164+
| **Poisoning** | BadNets, TrojanNN |
165+
| **LLM** | Prompt injection tools |
166+
167+
### ML Frameworks
168+
- PyTorch, TensorFlow
169+
- scikit-learn
170+
- Hugging Face
171+
- ONNX Runtime
172+
173+
### System Requirements
174+
| Spec | Minimum | Recommended |
175+
|------|---------|-------------|
176+
| RAM | 8GB | 16GB+ |
177+
| Disk | 50GB | 100GB+ |
178+
| CPU | 4 cores | 8+ cores |
179+
| GPU | Optional | NVIDIA CUDA recommended |
180+
181+
---
182+
183+
## Hardware Hacking Edition
184+
185+
**Target Audience:** Hardware security researchers, IoT pentesters
186+
187+
### Features
188+
- SDR tools for radio analysis
189+
- JTAG/SWD debugging tools
190+
- UART/SPI/I2C tools
191+
- RFID/NFC tools
192+
- Firmware analysis
193+
194+
### Included Hardware Tools
195+
| Category | Tools |
196+
|----------|-------|
197+
| **SDR** | GNU Radio, GQRX, SDR#, rtl-sdr |
198+
| **JTAG** | OpenOCD, JTAGulator |
199+
| **RFID** | Proxmark3, MFCUK |
200+
| **Firmware** | Binwalk, firmware-mod-kit |
201+
| **Logic** | sigrok, PulseView |
202+
| **RF** | HackRF, YARD Stick One tools |
203+
204+
### Hardware Support
205+
- RTL-SDR dongles
206+
- HackRF One
207+
- Proxmark3
208+
- Bus Pirate
209+
- Shikra
210+
- Flipper Zero
211+
- Logic analyzers
212+
213+
### System Requirements
214+
| Spec | Minimum | Recommended |
215+
|------|---------|-------------|
216+
| RAM | 4GB | 8GB+ |
217+
| Disk | 30GB | 50GB+ |
218+
| USB | 2.0+ | 3.0+ (required for SDR) |
219+
| CPU | 2 cores | 4+ cores |
220+
221+
---
222+
223+
## Edition Comparison
224+
225+
| Feature | Standard | Lite | Cloud | Auto | AI/ML | Hardware |
226+
|---------|----------|------|-------|------|-------|----------|
227+
| Tools Count | 135+ | ~50 | 80+ | 60+ | 50+ | 70+ |
228+
| ISO Size | 4GB | 2GB | 3.5GB | 3GB | 5GB | 3.5GB |
229+
| Min RAM | 4GB | 2GB | 4GB | 4GB | 8GB | 4GB |
230+
| GPU Support | Optional | No | Optional | No | CUDA | No |
231+
| Desktop | XFCE | XFCE | XFCE | XFCE | XFCE | XFCE |
232+
| ARM64 | Planned | ✅ | Planned | ✅ | No | ✅ |
233+
234+
---
235+
236+
## Download Links
237+
238+
| Edition | Download | Torrent |
239+
|---------|----------|---------|
240+
| Standard | [ISO](https://github.com/bad-antics/nullsec-linux/releases) | [Torrent](#) |
241+
| Lite | [ISO](https://github.com/bad-antics/nullsec-linux/releases) | [Torrent](#) |
242+
| Cloud | [ISO](https://github.com/bad-antics/nullsec-linux/releases) | [Torrent](#) |
243+
| Automotive | [ISO](https://github.com/bad-antics/nullsec-linux/releases) | [Torrent](#) |
244+
| AI/ML | [ISO](https://github.com/bad-antics/nullsec-linux/releases) | [Torrent](#) |
245+
| Hardware | [ISO](https://github.com/bad-antics/nullsec-linux/releases) | [Torrent](#) |
246+
247+
---
248+
249+
## Custom Edition Builder
250+
251+
Build your own custom NullSec Linux edition:
252+
253+
```bash
254+
git clone https://github.com/bad-antics/nullsec-linux.git
255+
cd nullsec-linux/builder
256+
257+
# Edit tool selection
258+
nano configs/my-edition.yaml
259+
260+
# Build ISO
261+
./build.sh --config configs/my-edition.yaml --output my-nullsec.iso
262+
```
263+
264+
See [Building](Building.md) for detailed build instructions.

‎docs/Home.md‎

Lines changed: 107 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,107 @@
1+
# 🐧 NullSec Linux Documentation
2+
3+
Welcome to the **NullSec Linux** documentation! A security-focused Linux distribution built for penetration testing, red team operations, and security research.
4+
5+
## 📖 Documentation Index
6+
7+
| Section | Description |
8+
|---------|-------------|
9+
| [Installation](Installation.md) | Installation methods and setup |
10+
| [Editions](Editions.md) | Available editions and use cases |
11+
| [Tools](Tools.md) | Pre-installed security tools |
12+
| [Configuration](Configuration.md) | System configuration |
13+
| [Customization](Customization.md) | Themes and customization |
14+
| [Building](Building.md) | Build from source |
15+
| [FAQ](FAQ.md) | Frequently asked questions |
16+
17+
---
18+
19+
## 🚀 Quick Start
20+
21+
### Download
22+
Download the latest ISO from the [Releases](https://github.com/bad-antics/nullsec-linux/releases) page.
23+
24+
### Boot Options
25+
- **Live Mode** - Boot directly from USB without installing
26+
- **Install** - Full installation to disk
27+
- **Forensics Mode** - No auto-mount, for forensic investigations
28+
29+
### Default Credentials
30+
```
31+
Username: nullsec
32+
Password: toor
33+
Root password: toor
34+
```
35+
⚠️ **Change these immediately after installation!**
36+
37+
---
38+
39+
## 📦 Editions
40+
41+
| Edition | Target Use Case | Tools Focus |
42+
|---------|-----------------|-------------|
43+
| **Standard** | General pentesting | 135+ security tools |
44+
| **Lite** | Low-resource systems | Core tools only |
45+
| **Cloud** | AWS/Azure/GCP testing | Cloud security tools |
46+
| **Automotive** | Vehicle security | CAN bus, ECU tools |
47+
| **AI/ML** | ML security research | Adversarial ML tools |
48+
| **Hardware** | Hardware hacking | SDR, JTAG, RF tools |
49+
50+
---
51+
52+
## 🔧 Pre-installed Tools
53+
54+
### Categories
55+
- **Reconnaissance** - Nmap, Masscan, Shodan CLI, theHarvester
56+
- **Web Testing** - Burp Suite, OWASP ZAP, SQLMap, Nikto
57+
- **Exploitation** - Metasploit, SearchSploit, BeEF
58+
- **Password Attacks** - John the Ripper, Hashcat, Hydra
59+
- **Wireless** - Aircrack-ng, Wifite, Kismet
60+
- **Forensics** - Autopsy, Volatility, Binwalk
61+
- **Reverse Engineering** - Ghidra, Radare2, GDB
62+
- **NullSec Suite** - All NullSec Tools pre-installed
63+
64+
---
65+
66+
## 💻 System Requirements
67+
68+
### Minimum
69+
- **CPU**: 2 cores
70+
- **RAM**: 4GB
71+
- **Disk**: 25GB
72+
- **GPU**: Basic VGA
73+
74+
### Recommended
75+
- **CPU**: 4+ cores
76+
- **RAM**: 8GB+
77+
- **Disk**: 50GB+ SSD
78+
- **GPU**: Dedicated GPU for password cracking
79+
80+
---
81+
82+
## 🎨 Desktop Environments
83+
84+
- **XFCE** (Default) - Lightweight and customizable
85+
- **KDE Plasma** - Full-featured desktop
86+
- **i3wm** - Tiling window manager
87+
88+
---
89+
90+
## 🔗 Related Projects
91+
92+
- [NullSec Tools](https://github.com/bad-antics/nullsec-tools) - Security toolkit
93+
- [Marshall Browser](https://github.com/bad-antics/marshall) - OSINT browser
94+
- [NullSec Framework](https://github.com/bad-antics/nullsec-framework) - Modular framework
95+
96+
---
97+
98+
## ⚠️ Legal Notice
99+
100+
NullSec Linux is designed for **authorized security testing and educational purposes only**. Users are responsible for ensuring they have proper authorization before testing any systems.
101+
102+
---
103+
104+
<p align="center">
105+
<b>Part of the NullSec Security Suite</b><br>
106+
<a href="https://github.com/bad-antics">@bad-antics</a>
107+
</p>

0 commit comments

Comments
 (0)