This document will instruct you in setting up Postmill for testing purposes.
(Psst! Instead of setting up PHP and all that stuff yourself, a better way to get started is using Docker.)
Make sure you have all the requirements available:
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.
Clone the repository somewhere and navigate there with the command line.
$ git clone https://gitlab.com/postmill/Postmill.git
$ cd Postmill
$ yarn install
$ yarn run build-prod
The public/build directory should now be populated.
Run composer install.
If this command fails, it is likely because your system doesn't have the minimum required PHP version or the necessary extensions.
Run vendor/bin/requirements-checker to check your PHP config for any misconfigurations. Fix any errors that arise.
Set up a PostgreSQL database.. You need a username, password, hostname (usually localhost), port (usually 5432), database name, and server version to continue.
Create an empty .env.local file in the project root. At minimum, you must define
your database configuration here:
You can copy other values from .env to override them in your installation.
Run bin/console doctrine:migrations:migrate to load the database schema.
Run php -S 127.0.0.1:8000 -t public to start the application.
php -S 127.0.0.1:8000 -t public
Navigate to http://localhost:8000/.
You should be good to go! A good next step would be to learn how to manage admin accounts.