> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.bearsampp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Switch PHP, Apache, or MySQL Versions in Bearsampp

> Learn how to switch between installed versions of Apache, PHP, MySQL, MariaDB, PostgreSQL, Node.js, and more using the Bearsampp tray menu.

Bearsampp lets you install multiple versions of the same module side by side and switch between them in seconds — no reinstalling, no manual config editing. You can have PHP 8.1 and PHP 8.3 both on disk and flip between them whenever your project needs it.

## Supported modules

Version switching is available for all binary modules:

<CardGroup cols={2}>
  <Card title="Apache" icon="server">
    Switch the web server version. Bearsampp stops Apache, updates config files, and restarts.
  </Card>

  <Card title="PHP" icon="code">
    Switch PHP version. Apache restarts automatically since PHP runs as an Apache module.
  </Card>

  <Card title="MySQL" icon="database">
    Switch the MySQL version and restart the MySQL service.
  </Card>

  <Card title="MariaDB" icon="database">
    Switch the MariaDB version and restart the MariaDB service.
  </Card>

  <Card title="PostgreSQL" icon="database">
    Switch the PostgreSQL version and restart the PostgreSQL service.
  </Card>

  <Card title="Node.js" icon="hexagon">
    Switch the active Node.js runtime. No service restart needed.
  </Card>

  <Card title="Memcached" icon="server">
    Switch the Memcached version and restart the Memcached service.
  </Card>

  <Card title="Mailpit" icon="envelope">
    Switch the Mailpit version and restart the Mailpit service.
  </Card>

  <Card title="Xlight" icon="folder-open">
    Switch the Xlight FTP server version and restart the service.
  </Card>
</CardGroup>

## How to switch versions

<Steps>
  <Step title="Open the tray menu">
    Right-click the Bearsampp icon in the Windows system tray.
  </Step>

  <Step title="Select the module">
    Hover over the module you want to change, for example **PHP**.
  </Step>

  <Step title="Open the Versions submenu">
    Click **Versions** in the module submenu. All installed versions appear as a list.
  </Step>

  <Step title="Select the new version">
    Click the version you want. Bearsampp shows a progress window while it:

    * Stops the affected service
    * Updates all configuration files to point to the new version
    * Reloads the internal configuration
    * Restarts the service with the new version

    A confirmation dialog appears when the switch is complete.
  </Step>
</Steps>

## Apache and PHP version compatibility

Apache and PHP must be compatible for your stack to work. Bearsampp checks this automatically when you switch either module and warns you if they don't match:

* When switching Apache: *"Apache X does not seem to be compatible with PHP Y."*
* When switching PHP: *"PHP X does not seem to be compatible with Apache Y."*

If you see either warning, switch the other module to a compatible version before using your local site.

<Note>
  Switching PHP also restarts Apache, because PHP runs as an Apache module. Both version changes happen in a single operation.
</Note>

## Verify the active versions

After switching, open `http://localhost` in your browser. The Bearsampp homepage dashboard shows the currently active version of every enabled module and whether each service is running.

<Tip>
  To download additional versions, visit [bearsampp.com/module](https://bearsampp.com/module). Place the downloaded module archive in the correct subfolder and it will appear in the **Versions** submenu the next time you open the tray menu.
</Tip>
