Building from Source

Building from Source

This guide explains how to build ryu_ldn_nx from source.

Prerequisites

Using Docker (Recommended)

• Docker
• Docker Compose

Native Build

• devkitPro with devkitA64
• libnx
• Atmosphere-libs (submodule)
• libtesla (for overlay)

Docker Build

The easiest way to build is using Docker:

# Clone the repository
git clone --recursive https://github.com/Ethiquema/ryu_ldn_nx.git
cd ryu_ldn_nx

# Build sysmodule
docker-compose run --rm build

# Build overlay
docker-compose run --rm overlay

# Run tests
docker-compose run --rm test

Build Outputs

After building:

• Sysmodule: sysmodule/ryu_ldn_nx.nsp
• Overlay: overlay/ryu_ldn_nx_overlay.ovl
• Debug symbols: sysmodule/ryu_ldn_nx.elf

Native Build

If you prefer building natively:

1. Install devkitPro

Follow the devkitPro getting started guide.

# Install required packages
dkp-pacman -S switch-dev libnx

2. Clone Repository

git clone --recursive https://github.com/Ethiquema/ryu_ldn_nx.git
cd ryu_ldn_nx

3. Build Sysmodule

cd sysmodule
make -j$(nproc)

4. Build Overlay

# Install libtesla
git clone https://github.com/WerWolv/libtesla.git /opt/libtesla

cd overlay
make LIBTESLA=/opt/libtesla

Creating a Release Package

To create a release-ready ZIP:

# Build everything
docker-compose run --rm build
docker-compose run --rm overlay

# Create package structure
mkdir -p release/atmosphere/contents/4200000000000010
mkdir -p release/switch/.overlays

# Copy files
cp sysmodule/ryu_ldn_nx.nsp release/atmosphere/contents/4200000000000010/exefs.nsp
cp sysmodule/ryu_ldn_nx.npdm release/atmosphere/contents/4200000000000010/main.npdm
cp sysmodule/res/*.json release/atmosphere/contents/4200000000000010/
cp overlay/ryu_ldn_nx_overlay.ovl release/switch/.overlays/

# Create ZIP (config is generated on first boot)
cd release && zip -r ../ryu_ldn_nx.zip .

Troubleshooting Build Issues

Submodules not initialized

git submodule update --init --recursive

Missing libnx

dkp-pacman -S libnx

Atmosphere-libs errors

Make sure you have the correct version:

cd sysmodule/Atmosphere-libs
git checkout <required-version>

libtesla not found

Set the LIBTESLA environment variable:

export LIBTESLA=/path/to/libtesla