This Porting Guide is the official guide to porting the Adélie Linux 1.0 system to new architectures. It has been re-written from the ground up to take advantage of the new Alpine-based build system in use as of 1.0-alpha3.

Many contributed to the final version of this guide, including Horst Burkhardt, Samuel Holland, and many others.

It is assumed that you, the reader, are familiar with compiling software and the Adélie build system. If you are not yet familiar with these concepts, start with our Developer's Guide, which will assist you in learning them.

Please also ensure that you are comfortable and properly rested before reading this guide. This will allow you to learn quicker, and be able to recall the information you have learned easier.

It is hoped by the author that you find this guide easy to understand and read. Please feel free to contact me or the Adélie Linux community if you have any suggestions on how to make this guide better. We'd love to hear from you, and we hope you enjoy using our distribution.

– A. Wilcox, 2018