minui-tailscale.pak

A MinUI and NextUI pak wrapping Tailscale, a secure and easy-to-use VPN.

Requirements

This pak is designed for the following MinUI Platforms and devices:

• tg5040: Trimui Brick (formerly tg3040), Trimui Smart Pro

The pak may work on other platforms and devices, but it has not been tested on them.

Installation

1. Mount your MinUI SD card.
2. Download the latest release from Github. It will be named Tailscale.pak.zip.
3. Copy the zip file to the correct platform folder in the "/Tools" directory on the SD card. Please ensure the new zip file name is Tailscale.pak.zip.
4. Extract the zip in place, then delete the zip file.
5. Confirm that there is a Tailscale.pak/launch.sh file on your SD card.

Note: The platform folder name is based on the name of your device. For example, if you are using a TrimUI Brick, the folder is "tg3040". Alternatively, if you're not sure which folder to use, you can copy the .pak folders to all the platform folders.

Auth Key

To log in to Tailscale, you need an authentication key. This can be generated from the Tailscale admin console. The key can be either a reusable key or an ephemeral key. The key will need to be placed in a file called authkey in the root of the SD card. The file should contain only the key itself, with no extra spaces or newlines. The pak will look for this key when starting for the first time. Once started the key will be deleted.

1. Go to the Tailscale keys page in the admin console.
2. Click on "Generate Auth Key".
3. Choose the type of key you want to generate (reusable or ephemeral).
4. Click "Generate Key" copy the key.
5. Create a file called authkey in the root of your SD card.
6. Paste the key into the authkey file and save the file.
7. Unmount your SD Card and insert it into your MinUI device.

Usage

Browse to Tools > Tailscale and press A to enter the Pak.

Start/Stop Tailscale

You can start or stop Tailscale from the app's main menu. When Tailscale is running, you will see a message indicating the PID of the Tailscale process.

Start on Boot

You can enable or disable starting Tailscale on boot from the app's settings menu.

Debug Logging

Debug logs are written to the $SDCARD_PATH/.userdata/$PLATFORM/logs/ folder.

Acknowledgements

• MinUI by Shaun Inman.
• minui-list and minui-presenter by Jose Diaz-Gonzalez.
• NextUI by @ro8inmorgan, @frysee and the rest of the NextUI contributors.
• Also, thank you, Jose Diaz-Gonzalez, for your pak repositories, which this project is based on.

License

This project is released under the MIT License. For more information, see the LICENSE file.