Installing the Server¶

This chapter explains how to install the FIRERPA server. The FIRERPA server is the most crucial component and the fundamental underlying service. You can choose to install it via the APK we provide (supports auto-start on boot), the Magisk module (supports auto-start on boot), or manually. Their installation complexity increases in order.

Installing via APK¶

First, we introduce the simplest installation method. This method requires no extra steps; you only need to install our auto-install and auto-start APK. For detailed installation steps, please refer to the Quick Start chapter.

Getting the Device Architecture¶

Since FIRERPA supports multiple CPU architectures, downloading an incorrect server version will prevent it from executing properly. Therefore, you need to obtain the device's architecture before installation. You can run the following command:

getprop ro.product.cpu.abi

For modern physical phones, this command typically outputs arm64-v8a; for emulators (such as LDPlayer), when creating a new emulator, you can choose a 32-bit or 64-bit Android system, where the 32-bit system corresponds to x86 and the 64-bit system to x86_64; some older Xiaomi models may output armeabi-v7a. Remember this output value.

Service Configuration¶

Please refer to the Service Configuration chapter to learn how to configure service startup items. Relevant configuration details are also covered in the introductions of various features.

Installing via Magisk¶

If your device uses Magisk, you can complete the installation in the simplest way, and FIRERPA can auto-start on boot. The Magisk version must be ≥ 20.4, and installation is only supported through the Magisk App.

Download lamda-magisk-module.zip from the lamda/releases page and push it to /sdcard. Open the Magisk App, navigate to "Modules" → "Install from storage", select lamda-magisk-module.zip, and wait a moment.

If you want the service to automatically set a proxy or connect to FRP forwarding upon startup, please refer to the Service Configuration chapter to write the corresponding configuration. Save the configuration in standard ini format, rename the file to properties, and place it into the common folder inside the module zip file lamda-magisk-module.zip. To preinstall a service certificate during Magisk module installation, you can generate a PEM certificate as described in the Server Certificate chapter, rename it to lamda.pem, and also drag it into the module's common folder. If you need to preauthorize Built-in ADB, write the content of your local adbkey.pub file into a file named adb_keys and drag it into the common folder.

Manual Installation¶

Download the latest version of lamda-server-arm64-v8a.tar.gz from the release page lamda/releases, and use the adb push command to push the file to the device's temporary directory /data/local/tmp.

adb push lamda-server-arm64-v8a.tar.gz /data/local/tmp

Once done, enter adb shell. If the device has root privileges, first run the su command to switch users; otherwise, you can directly execute the following commands with the current shell identity:

INSTALLDIR=$( [ $(id -u) -eq 0 ] && echo /data/ || echo /data/local/tmp )

echo "Server install directory: $INSTALLDIR/server"

tar -C $INSTALLDIR -xzf /data/local/tmp/lamda-server-arm64-v8a.tar.gz
rm /data/local/tmp/lamda-server-arm64-v8a.tar.gz

Manual Startup¶

Enter adb shell, and according to the current device status, choose to run the following command as shell or root. After executing, wait for the command to return; if the output shows llllaamDaa started, it means the service started successfully and has entered background mode. You can then safely exit adb shell and access the FIRERPA service. Otherwise, troubleshoot based on the error messages below.

sh /data/server/bin/launch.sh

Uninstalling the Service¶

FIRERPA manages its own data in a very standardized manner and absolutely does not randomly place files in your system. For Magisk installations, simply remove the module in the Magisk app; for APK installations, use the uninstall function within the APK.

Before uninstalling, please first shut down the service and wait at least 30 seconds to ensure the service exits gracefully.

rm -rf /data/server /data/usr # /data/local/tmp/usr

This will completely remove FIRERPA from your device. It is recommended to reboot the device after execution.