> For the complete documentation index, see [llms.txt](https://za.docs.rechtlogisch.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://za.docs.rechtlogisch.de/beta/setup/upgrade-apache.md).

# Upgrade Apache

Test instance runs Apache 2.4.71

{% hint style="info" %}
Currently performed manually on the test instance
{% endhint %}

{% stepper %}
{% step %}

### Download latest Apache 2.4 version

Go to <https://www.apachelounge.com/download/> and download latest version of Apache 2.4 (win64 VS18) as a ZIP archive&#x20;
{% endstep %}

{% step %}

### Extract ZIP

For example using 7-Zip or native Windows extraction tool
{% endstep %}

{% step %}

### Stop Apache

Open XAMPP and stop Apache. Alternatively you can stop the Apache service in `services.msc`
{% endstep %}

{% step %}

### Replace Apache

Rename `C:\xampp\apache` to `C:\xampp\apache-old`

Move new extracted Apache version to `C:\xampp\apache`
{% endstep %}

{% step %}

### Copy files from `apache-old`

**curl-ca-bundle.crt**

Copy `C:\xampp\apache-old\bin\curl-ca-bundle.crt`  to `C:\xampp\apache\bin\curl-ca-bundle.crt`. (Alternatively download latest from <https://curl.se/docs/caextract.html> and rename to `curl-ca-bundle.crt`)

**httpd-xampp.conf**

Copy `C:\xampp\apache-old\conf\extra\httpd-xampp.conf` to `C:\xampp\apache\conf\extra\httpd-xampp.conf`
{% endstep %}

{% step %}

### Compare and adjust configuration

Compare files in `C:\xampp\apache\conf\` with `C:\xampp\apache-old\conf\` and set values in  `C:\xampp\apache\conf\` accordingly.

Especially four files need special attention:

* apache\conf\httpd.conf
* apache\conf\extra\httpd-ssl.conf
* apache\conf\extra\http-default.conf
  * Timeout 300
* apache\conf\extra\httpd-vhosts.conf
  * Comment out not needed VirtualHosts
    {% endstep %}

{% step %}

### Start Apache

Open XAMPP and start Apache. Alternatively you can start the Apache service in `services.msc`
{% endstep %}

{% step %}

### Check for any startup errors

Inspect `C:\xampp\apache\logs\error.log` for any errors or warnigs. Fix them if any present.
{% endstep %}
{% endstepper %}
