Troubleshooting

Why are uploads not working?

Chances are, you are using a Windows system with a virtual machine. Windows doesn't like unix-style symlinks, which the Laravel storage system relies on. Restart your virtual machine with administrator privileges on Windows. Issue a php artisan storage:link command from the root of your installation. That should do the trick.

How do I get mail working?

Coldreader relies on the standard mail systems baked in to Laravel.

Check out the excellent documentation from Laravel on configuring mail.

Personally, I have had great results with the Mailgun driver. A Mailgun account is free for the first 10,000 messages a month.

How do I get the parse loop to run automatically?

Every Aspect has a parse() function, which allows it to make updates and changes to itself, or other Subjects or Aspects.

To make sure the parse loop runs regularly, you will want to create a cron job on the server.

Make sure you are logged in to the server with an account which has read-write-execute permissions on the Coldreader files.

Create the cron job in the standard way. On Ubuntu:

$ crontab -e

Add the following line to the file:

* * * * * php /path/to/coldreader/artisan schedule:run >> /dev/null 2>&1

That will run the scheduler once per minute, and your parse functions will execute according to their logic.