Decentralized social software using ActivityPub, written in Kotlin!
- Setup and forget. Aster shouldn't be a pain to run.
- Provide typical wants and needs of a social software.
- Allow developing plugins for extending capabilities with ease.
- Make sure users choices are respected, especially blocks and mutes.
To build Aster, you'll need at least Java 21. For development, the Jetbrains Runtime is recommended.
You'll also need Node.js (LTS version recommended) and pnpm (npm i -g pnpm).
Run the build script ./aster.sh build, and then grab the JAR from target/aster-*-jar-with-dependencies.jar.
To run Aster, you just need a PostgreSQL database.
Copy configuration.example.yaml to configuration.yaml and fill out the connection information.
After that, run ./path/to/aster.jar migration:execute and your database will be set up.
After setting up a user, you can promote them to an Admin role with the CLI. First, get the ID of the generated Admin role by running ./path/to/aster.jar role:list, and then ./path/to/aster.jar role:give {User ID} {Role ID}.
This usually happens when you run a migration before it's been formatted. Afterward, the checksum will be different. You can run ./path/to/aster.jar migration:repair to fix them.
Contributions are welcome, but Aster is in early development and I may have plans for how to do things already. You should contact me before opening a pull request or working on anything so we can get on the same page.