🚀 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:
- run $ apxdev
- open in the same machine http://admin.apxtri.farm.test
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.