palladiumcore/docker-build/README.md

# Docker Build System for Palladium Core

Docker-based build system for creating Palladium Core binaries using Ubuntu 20.04+ containers on x86_64 architecture.

## Build Environment

All builds use:
- **Base OS**: Ubuntu 20.04 or newer
- **Container Platform**: Docker
- **Host Architecture**: x86_64 (AMD64)
- **Build Method**: Cross-compilation for target platforms

## Linux x86_64 Build

### Overview

This build creates native Linux x86_64 binaries using a Docker container based on Ubuntu 20.04. The build process:

1. **Builds a Docker image** (`palladium-builder:linux-x86_64-ubuntu20.04`) containing all build dependencies
2. **Copies the entire repository** into the container during image build
3. **Runs the build process** entirely inside the container using the `depends` system
4. **Outputs binaries** to a mounted volume for host access

### Quick Start

```bash
cd docker-build
chmod +x build-linux-x86_64.sh
./build-linux-x86_64.sh
```

Binaries will be available in `../build/linux-x86_64/` directory.

### Prerequisites

- Docker installed and running ([installation guide](https://docs.docker.com/get-docker/))
- Sufficient disk space for the build process (at least 10 GB free)
- Internet connection for downloading dependencies

### Produced Binaries

The following binaries are built and copied to the output directory:

- `palladiumd`: Main daemon
- `palladium-cli`: Command-line client  
- `palladium-tx`: Transaction utility
- `palladium-wallet`: Wallet utility
- `palladium-qt`: GUI application (if Qt dependencies are available)

### Output Directory

Binaries are placed in: `../build/linux-x86_64/` (relative to the docker-build directory)

### Troubleshooting

**Permission errors:** The build script automatically handles file permissions using host UID/GID

**Build failed:** Run interactive container for debugging:
```bash
docker run --rm -it -v "$(pwd)/../build/linux-x86_64":/out palladium-builder:linux-x86_64-ubuntu20.04 bash
```

**Docker build issues:** Ensure Docker has sufficient resources and the daemon is running

**Missing dependencies:** The Dockerfile installs all required build dependencies automatically

## Windows x86_64 Build

### Overview

This build creates Windows x86_64 executables using cross-compilation in a Docker container based on Ubuntu 20.04. The build process:

1. **Builds a Docker image** (`palladium-builder:windows-ubuntu20.04`) containing MinGW-w64 cross-compilation toolchain
2. **Copies the entire repository** into the container during image build
3. **Cross-compiles for Windows** using the `depends` system with `x86_64-w64-mingw32` target
4. **Outputs .exe files** to a mounted volume for host access

### Quick Start

```bash
cd docker-build
chmod +x build-windows.sh
./build-windows.sh
```

Windows executables will be available in `../build/windows/` directory.

### Prerequisites

- Docker installed and running ([installation guide](https://docs.docker.com/get-docker/))
- Sufficient disk space for the build process (at least 12 GB free)
- Internet connection for downloading dependencies and MinGW-w64 toolchain

### Produced Executables

The following Windows executables are built and copied to the output directory:

- `palladiumd.exe`: Main daemon
- `palladium-cli.exe`: Command-line client
- `palladium-tx.exe`: Transaction utility
- `palladium-wallet.exe`: Wallet utility
- `palladium-qt.exe`: GUI application (if Qt dependencies are available)

### Output Directory

Executables are placed in: `../build/windows/` (relative to the docker-build directory)

### Cross-Compilation Details

- **Target Triple**: `x86_64-w64-mingw32`
- **Toolchain**: MinGW-w64 cross-compiler
- **Dependencies**: Built using the `depends` system for Windows target
- **Configuration**: Uses `CONFIG_SITE` for proper cross-compilation setup

### Troubleshooting

**Permission errors:** The build script automatically handles file permissions using host UID/GID

**Build failed:** Run interactive container for debugging:
```bash
docker run --rm -it -v "$(pwd)/../build/windows":/out palladium-builder:windows-ubuntu20.04 bash
```

**Cross-compilation issues:** Ensure the MinGW-w64 toolchain is properly installed in the container

**Missing .exe files:** Check that the configure script detected the Windows target correctly

**Docker build issues:** Ensure Docker has sufficient resources and the daemon is running