2025-10-08 13:20:33 +00:00
2025-10-01 15:09:44 +02:00
2025-10-01 15:09:44 +02:00
2025-10-01 15:09:44 +02:00
2025-10-01 15:09:44 +02:00
2025-06-27 06:58:44 +02:00
2025-07-10 09:12:51 +02:00
2025-06-24 08:50:58 +02:00
2025-06-24 08:50:58 +02:00
2025-08-25 08:57:39 +02:00
2025-06-27 06:58:44 +02:00
2025-07-01 08:13:59 +02:00
2025-06-27 06:58:44 +02:00
2025-10-01 15:09:44 +02:00
2025-10-01 15:09:44 +02:00
2025-10-08 13:20:33 +00:00

🚀 apXtri — Build, Host & Decentralize

Why apXtri?

Are you a system administrator or a web developer (backend, frontend, or fullstack) looking for a project that goes beyond the usual stack?
apXtri is an open-source infrastructure designed to create a decentralized economy around hosting, development, and community management.

With apXtri, you can:

  • Host web apps, APIs, and pages for groups (tribes) on your own servers (towns).
  • Manage encrypted identities via PGP for users (pagans), ensuring anonymity and security.
  • Define and enforce nested rules (tribe → town → nation) automatically recorded on a blockchain.
  • Generate and exchange tokens to pay for hosting, dev, or community services.
  • Create traceable digital contracts and handle disputes through decentralized arbitration.

👉 In short: apXtri is your toolbox to launch a decentralized SaaS platform.


⚙️ Tech stack (100% open source & auditable)

  • Ubuntu LTS (desktop for dev, server for production)
  • Caddy: native HTTPS & reverse proxy
  • Node.js / Express.js: RESTful endpoints
  • JSON Schema: structured data management
  • Internal blockchain: rules & traceability

📖 API Documentation: adminapi doc


🛠️ Quick installation

Requirements:

  • Ubuntu machine (physical or VM) recommendation: 8 GB RAM / 500 GB SSD
  • Sudo-enabled user
# Simplest way to get one from a fresh installation if not already one, replace {user} by an appropriate name
sudo adduser {user}
sudo passwd {user}
sudo usermod -aG sudo {user}
groups {user}
# check you get as output : {user} : {user} sudo users
su -{user}
# you are connected as {user} with sudo accessrights
  • Install from a launch.sh
    sudo apt install wget -y && \
    sudo wget -O launch.sh https://gitea.ndda.fr/apxtri/apxtri/raw/branch/main/setup/launch.sh && \
    sudo chmod +x launch.sh && \
    ./launch.sh

👉 Already installed? Add --clean to reset your node. ⚠️ Warning: this option will erase all apxtri data and reinstall from the latest release.

Once complete, follow instruction in the log:

in dev:

in prod: Quick start:

  • In log you'll get PUBLIC IP where your serveur is hosted
sudo systemctl start apxtri
sudo systemctl status apxtri # to check that all is fine  
  • Use your personnal PC and open /etc/host and add|modify in the line: {PUBLIC IP} admin.apxtri.farm.ants
  • Open in your PC's browser http://admin.apxtri.farm.ants (use a browser that allow you to access http)
  • Follow online instruction to finalize installation, you will need your personnal domaine name to join the blockchain.

➡️ See the wiki - setup for production setup and advanced options.


🎯 Why join apXtri?

  • 🧩 For sysadmins: a ready-to-install, auditable, and scalable project.
  • 💻 For developers: a playground to build apps, endpoints, and interfaces in a decentralized environment.
  • 🌍 For communities: an ecosystem outside centralization, giving power back to users.

👉 Join apXtri and build your own digital decentralized town.


FAQ

Q: Do I need blockchain expertise to run apXtri?
A: No. The blockchain is managed automatically by each town node. You only need basic sysadmin skills to set up and run it.

Q: Can I use apXtri for private projects?
A: Yes. Tribes can be public or private (invite-only), making it suitable for both open communities and closed groups.

Q: What happens if my server goes offline?
A: Each town manages its own data. If your node goes offline, your hosted tribes become unavailable, but other towns remain unaffected.

Q: Can I integrate my own apps or APIs?
A: Absolutely. apXtri is designed to host custom apps, APIs, and services through RESTful endpoints.

Q: Is there a way to contribute as a developer?
A: Yes. You can build web interfaces, extend APIs, or improve the core. Contributions are welcome through the official repo.

Description
Main tribe that manage many other tribes in an apXtri town
Readme 8.1 MiB
Languages
JavaScript 88%
Shell 12%