Building and Flashing

Building and Flashing

This page summarises building Gargoyle from source. For the most detailed and up-to-date instructions, see the README.md and the community wiki.

Prerequisites

A 64-bit Linux system (Ubuntu is well tested; a VM is fine). Install the build dependencies listed in the repository README.md. Python 3 must be on your PATH (python-is-python3 on Ubuntu).

Get the source

git clone https://github.com/ispyisail/gargoyle.git
cd gargoyle

Build

Gargoyle builds one target at a time. From the repository root:

./build.sh <target>

Common targets: ath79, mediatek, ipq40xx, x86.

The first build for a target takes a while — it downloads the OpenWrt toolchain and all package sources. Subsequent builds are incremental.

Finished images are placed under images/<target>/.

Flashing

Flashing is device-specific. Follow the instructions for your exact router model on the community site. In general you will either use the stock firmware's upgrade page, OpenWrt's sysupgrade, or a bootloader recovery method (TFTP/U-Boot) depending on the device.

Warning: flashing the wrong image for your device can brick it. Always confirm the image matches your exact model and hardware revision.