The App Server is a FastAPI/MongoDB program which stores apps for use in Administer and a website later on, there is no backend panel or anything. What you see is what you get.
Install python3 3.13 and pip.
In addition to that, make sure you have a MongoDB instance which runs locally ONLY without a password. Because it will not have a password, exposing it to the internet is a bad idea.
Just clone the repo and run the installer:
git clone https://github.com/administer-org/app-server
cd app-server
chmod +x Install_AOS.sh
./Install-AOS.sh
AOS and a systemd unit will be installed automatically.
Run the following (assuming you already have python3 and pip):
pip install uv
uv venv
# Enter the venv.. it varies from OS to OS so if this doesn't work just run the command it tells you to
source .venv/bin/activate
uv pip install .
Feodra is used for aos-us-3 and we are having a lot of configuration errors. If AOS refuses to run, please run sudo setenforce 0
to allow Python to run.
And you're done! Make sure to edit your __aos__.json
and config.json
files, then run aos
.
See here: https://docs.admsoftware.org/legal/privacy
We welcome contributions as long as they are meaningful. Please ensure you are familiar with our code standards and libraries before making pull requests. For larger changes, you may want to discuss a change in our Discord beforehand.
All of Administer and your usage of it is governed under the GNU AGPL 3.0 license.
Administer Team 2024-2025