Notice: New Fork of Postmill. Lets see what we can do ladies an gents! Message me in discord to become a collaborator/dev team member.

Postmill

Postmill is a free, web-based, social link aggregator with voting and threaded comments. It is built on the Symfony framework. Any similarities between this software and that of a large community symbolised by an alien logo are purely coincidental.

Requirements

PHP >= 7.1 with the APCu, curl, gd, mbstring, PDO_PGSQL and xml extensions.
PostgreSQL >= 9.3
Composer
Node.js (>= 8.x preferred)

Postmill should be able to run under any Unix environment. It has been tested to work under Linux, macOS, and Windows 10's Linux subsystem. Running directly on Windows may work, but is unsupported.

Getting started

Clone the repository somewhere and navigate there with the command line.

Building frontend assets

Run npm install.
Run npm run build-dev. The public/build/ directory should now contain some files.

Setting up the backend

Run composer install.
You should now have a .env file in the project root. Edit this to your liking or leave the defaults alone, but you must change DATABASE_URL.

Instructions for setting up a database can be found at docs/database-setup.md.
Run vendor/bin/requirements-checker to ensure your environment meets necessary requirements needed to run Postmill. Fix any errors that arise.
Run bin/console doctrine:migrations:migrate to load the database schema.
Run bin/console app:user:add <username> --admin to create a user account.
Run bin/console server:run to start the application.
Navigate to http://localhost:8000/. Log in with the credentials you chose in step 2.

Reporting issues

Bugs and feature requests should be reported on the issue tracker.
Get support on Postmill's Matrix channel: #postmill:matrix.org.

You can email emma1312@protonmail.ch to disclose or discuss something in private with the creator of the software.

Contributions

You are always welcome to submit pull requests for things like bug fixes, documentation, and new translations. Pull requests for new/altered functionality are likely to be rejected, as this must be discussed with the community beforehand.

If you'd like to support me with money, you can send Bitcoins to 1AXAH2ZaHfVsq2xnbXRN9497FpUAri8x72.

License

The software is released under the zlib license. See the LICENSE file for details.

psineur / therealgd