View source for KB00008:PartKeepr behind a reverse proxy

= PartKeepr behind a reverse proxy =

Sometimes it's required to run PartKeepr behind a reverse proxy. Depending on your setup, there are two possibilities. In this example, <code>http://internal-partkeepr/</code> could run on an internal virtual machine, not accessible from the outside.

* Run PartKeepr on the same path (e.g. <code>https://partkeepr.example.org/</code> maps to <code>http://internal-partkeepr/</code>)
* Run PartKeepr on a different path (e.g. <code>https://example.org/parts/</code> maps to <code>http://internal-partkeepr/</code>)

The first case is simple, nothing needs to be done in that case - this should work with all PartKeepr versions.

The second case is a bit more difficult: PartKeepr loads the frontend resources like images and javascripts from URLs, but these must be known to PartKeepr to properly generate them. As PartKeepr only has the information where it is called on (like the virtual machine in our example), it doesn't know that the user's browser expects the resources to be below <code>https://example.org/parts/</code> and would generate links like <code>https://example.org/</code> - now the user's browser can't find them.

Starting from PartKeepr 1.4, it is possible to configure a fixed external URL to solve that problem.

To configure it, you need to make two settings.

In your <code>app/config/parameters.php</code> file, add the following line where you configure the first external url:
<pre>
$container->setParameter('partkeepr.frontend.base_url', "https://www.example.org/parts/");
</pre>

Additionally, create a file called <code>app/config/config_custom.yml</code> and configure your external url as well. Note the proper indentation!

<pre>
framework:
    assets:
        base_urls:
            - 'https://www.example.org/parts/'
</pre>

Now re-run setup or [[Developers/Re-generating_the_environment|re-generate your environment]] and you should see that the generated URLs in the PartKeepr frontend all begin with the url you've set.

It is important to note that this only works in the '''production''' environment - it will not work in the '''dev''' environment!
[[Category:Knowledge Base]]