Skip to content

Repository files navigation

ALFIS Android

A small app that runs an ALFIS DNS server on Android.

Currently using ALFIS v0.10.0 (patched for Android support, a one line patch, see the patch file).

Note: Currently the scope of the project is just to run the DNS server, not registering keys/domains (anything involving mining). If you want that functionality, please open an issue stating so.

Goals

  • Run ALFIS DNS server on Android
  • Display logs in the UI
  • Make the server app run as a foreground service and disable battery optimizations
  • Add a way to start/stop server from the UI
  • Add a way to configure DNS settings from the UI

Building

To build the app:

  • Download and patch the upstream ALFIS crate by running ./patch-alfis.sh
  • Run cargo apk build (needs cargo-apk, you can also try using a different build tool but you will have to adapt the crate yourself)

For release builds you can run cargo apk build --release, but you will have to provide a keystore.jks for signing (and update the Cargo.toml accordingly).

Contributing

All types of contributions are welcome!

By contributing, you agree to license your contributions under the terms of the AGPL-3.0-or-later License (see SPDX). And you agree to follow the AI usage guidelines outlined below.

All contributions must be submitted to the main repo.

AI usage

For issues, discussions, etc... AI usage for translation is permitted. But it is the responsibility of the human sender to ensure that the translation is accurate.

For code, documentation, etc... AI usage is permitted only for review and boilerplate generation (aka tab auto completion, though using it excessively is not recommended). Also then, the human author is responsible for any bugs or issues.

This is done to ensure the project stays high quality (at least as much as I can (o_o;)), and the license remains unstained by unlicensable AI generated code.

License

Copyright (c) 2026 AMA

This project is licensed under the AGPL-3.0-only License (see LICENSE or SPDX).

However, all outside contributions must be licensed under the AGPL-3.0-or-later License (see SPDX) to allow the project to update to a newer version of the license if I wish to do so.

About

A simple app that runs an ALFIS DNS server on Android

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages