Run locally

1. composer install
2. cp .env.example .env and configure .env file
3. yarn install
4. yarn run dev
5. Optional: make the search work:
   1. Install and run meilisearch locally
   2. Configure and run a queue (php artisan queue:listen --queue=high,low,default)

Configuring search

Search in production is done with Meilisearch. You can use other drivers if you want to.

That being said, if you want to index new data, or add additional data to search data for, you need to indicate all the indexes of this new data in SetupApplication.php – otherwise, Meilisearch won't know the indexes and you will end up with an error message saying that data is not filterable.

Docker

We have a docker image that you can use to run this project locally.

First you need setup authentication to the Container registry

Then play with the image:

docker run -p 8080:80 ghcr.io/monicahq/monica-next:main

This runs the image locally on port 8080 and using sqlite. You can then access the application at http://localhost:8080.

Configuration

Note that you'll need to setup a mail mailer to be able to register a user. You can try to use the log mailer like this:

docker run -p 8080:80 -e MAIL_MAILER=log ghcr.io/monicahq/monica-next:main

For more complex scenario (database setup, queue, etc.) see https://github.com/monicahq/docker/tree/main/.examples

Build it yourself

You can also build your image locally using yarn docker:build and run it with yarn docker:run.