# Basalt Linux — Build Scripts

This directory contains everything you need to build your own Basalt Linux ISO.

## Requirements

- Debian 13 (Trixie) or compatible system
- Docker (recommended) or direct live-build tools
- 20+ GB free disk space
- Root access (for ISO creation)

## Quick Start (Docker)

```bash
# Build the ISO
./build-docker.sh

# Clean build (delete all caches)
./build-docker.sh --clean
```

The ISO will be placed in the `output/` directory.

## Manual Build

```bash
# Install live-build if not present
sudo apt install live-build

# Run the build script
sudo bash bldbasalt
```

## Output

After a successful build, you will find:
- `Basalt-<version>-Obsidian-amd64.iso` — the bootable ISO image
- `Basalt-<version>-Obsidian-amd64.iso.sha256` — checksum file

## Structure

```
public/
├── basalt/          # Live-build configuration
├── bldbasalt        # Main build script
├── build-docker.sh  # Docker build wrapper
├── Dockerfile       # Docker image definition
└── README.md        # This file
```

## License

MIT — build scripts and configuration files are open source.
