Troubleshooting

In most cases Grav should work out of the box, but at times you may encounter Server Errors or some other issues. In this chapter you can find the answers you may be looking for.

404 Not Found

404 Not Found There are a couple of reasons you might receive a Not Found error, and they are each caused by different factors. Caution The examples below are for the Apache Web Server which is the most common server software used. IIS use of .htaccess file After adding URL Re...

Grav Server Error

Grav Server Error Server errors are almost always caused by misconfiguration of Grav. Something unexpected happened and because of that Grav is unable to recover and serve the page. When you see this message it means your server is running in Production mode to hide potentially sensitive inf...

500 Internal Server Error

500 Internal Server Error The server encountered an internal error or misconfiguration and was unable to complete your request. Please contact the server administrator at webmaster@localhost to inform them of the time this error occurred, and the actions you performed just before this error....

403 Forbidden

403 Forbidden There is an obscure but persistent issue with Apache on Windows causing a 403 forbidden error. Basically, Apache won't allow the : in the URL that works on other systems due to a security concern based on the fact that windows paths can have colons in them: C:\some\path....

Invalid Security Token

Invalid Security Token Problem: You get this error in the Admin panel when logging in on performing operations There are a few possible causes of the problem, all linked to the Session: Try reloading your browser to get a fresh token Try clearing your browser session cookies, Try...

Permissions

Permissions Depending on your hosting environment, permissions may or may not be an issue you need to concern yourself with. The important thing to understand is that there is a potential issue if the user you use to edit your files on the file-system is different from the user that PHP runs under...

Proxy issues

Proxy issues Running GPM commands behind a proxy might result in an error. cURL allows you to set the proxy as an environment variable (http_proxy and https_proxy), without changes needed in Grav. See http://stackoverflow.com/questions/7559103/how-to-setup-curl-to-permanently-use-a-proxy...

Common Problems

Common Problems Here you can find information on problems and issues raised on Grav forum and in the Discord Chat server that occur frequently enough that we thought we would save time and list the problem and the relevant solution in one easy to find location. Cannot connect to the GPM Pr...

htaccess

htaccess Grav comes complete with its own .htaccess file. This file enables Grav to operate properly and should be kept in its root folder. You may encounter issues that can be resolved using the .htaccess file. Apache is one of the most popular server solutions available today. It's free, a...