Live-Only Distro that focuses on lightweight live booting. A spiritual successor to the venerable Knoppix operating system. https://pseudodragon.org
  • Shell 89%
  • Vim Script 11%
Find a file
GarretSidzaka bdf287dd88 Update README.md
tweaks to the titles
2026-05-15 06:19:23 +00:00
auto switched back to rolling 2025-07-26 01:00:45 -07:00
kali-config moved some menu files to perhaps the correct spotwq 2025-08-23 21:21:21 -07:00
qemu Add new directory 2025-08-11 19:35:33 -07:00
.getopt.sh Drop --salt 2025-01-21 15:26:36 +00:00
.gitignore Fix typo 2025-04-17 14:53:38 +01:00
.gitlab-ci.yml Update .gitlab-ci.yml file 2025-07-07 18:14:44 -07:00
build.sh switched back to rolling 2025-07-26 01:00:45 -07:00
docker-compose.yml Edit docker-compose.yml 2025-08-11 19:36:15 -07:00
README.md Update README.md 2026-05-15 06:19:23 +00:00

Pseudodragon OS Distribution

pseudodragon logo

Description

Live-Only Distro that focuses on lightweight live booting. A spiritual successor to the venerable Knoppix operating system.

What's it good for?

* Live booting with your persistent files, anywhere you can plug in a USB!
* Browsing the web securely.
* Managing remote servers and websites.
* Use your favorite applications on the go!
* Develop-It-Inside-It (DI3) all the tools to develop the OS are self-contained.

What's it not so great at?

Not intended for penetration testing or red-teaming because those tools are not present.

Not usable for heavy duty gaming, as the live filesystem can cause extreme latency during play.

Website

https://pseudodragon.org

Team

GarretSidzaka - Founder and DevOps Lead

SilverWyvern360 - Mascot Creator, Lead Artist, and Firmware Developer

AstralDestiny - Networking Director and Security Researcher

MrGrumpyMonkey - Quality Assurance Lead and DevOps Engineer

PinkJellies99 - Contributing Artist

Pseudo-Live Build-Scripts

live-build configuration for Pseudo ISO images.

These are the same build-scripts that the Kali team uses to generate the official Kali Linux base images, found here: kali.org/get-kali/.

Build your Pseudo Linux image today!


These images can be used to live boot into Pseudo, from such a USB/CD/DVD/sdCard, as well offers a basic installation. For more customization during setup, see kali-installer.


Have a look at Live Build a Custom Kali ISO for explanations on how to use this repository.

There are also other code examples of live-build, as well as code examples for pre-seed to automate/unattended installation.


Help

$ ./build.sh --help
Usage: ./build.sh [<option>...]

  --distribution <arg>
  --proposed-updates
  --arch <arg>
  --verbose
  --debug
  --variant <arg>
  --version <arg>
  --subdir <arg>
  --get-image-path
  --no-clean
  --clean
  --help

More information: https://www.kali.org/docs/development/live-build-a-custom-kali-iso/
$

Usage Examples

Both images types, using the latest packages:

$ ./build.sh
[...]

Manually define which Kali mirror to pull from, as well as be more detailed in output:

$ echo "http://kali.download/kali" > .mirror
$
$ ./build.sh --verbose
[...]

Build a different Live image version (GNOME and KDE Plasma):

$ ./build.sh \
  --debug \
  --variant gnome
[...]
$
$ ./build.sh \
  --debug \
  --variant kde
[...]
$