Running PHP on IBM/Lotus Domino server

Running PHP on IBM/Lotus Domino server

September 28, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Running PHP on IBM/Lotus Domino server

Running PHP on IBM/Lotus Domino Server

As a senior developer specializing in PHP-based web applications, I’m often asked about deploying open-source platforms like WordPress and Magento on non-standard servers like the IBM Lotus Domino platform. While the Domino server is typically associated with Lotus Notes databases, it’s actually quite flexible when it comes to running modern web technologies.

Current Setup and Observations

You’ve already made great progress by installing PHP 5.3.29, MySQL 5.6.21.1, and phpMyAdmin on your Domino server. You’ve correctly configured the URL-to-Directory mapping document in the Domino Directory to process .php files through the PHP-CGI executable.

Your setup is currently working for most scenarios:

  • You can access http://domain.com/php/info.php successfully.
  • You’re able to create MySQL databases using phpMyAdmin.
  • WordPress installation seems to be proceeding smoothly.

However, you’ve encountered a 403 error when trying to access URLs that only contain the directory name. For example, http://domain.com/wp/wp-admin/ returns an “unable to process request” message because the server is configured to disallow directory browsing by default.

Understanding the Domino HTTP Service

The Domino HTTP service uses a specific file-naming convention for its index file handling. By default, it looks for files named index.htm or index.html. If one of these files exists in the specified directory, the server will process the request without requiring an explicit filename.

In your case, you want to add .php files (specifically index.php) to this list so that the server can look for them when processing URLs with only a directory name.

Configuring Domino HTTP Service to Accept index.php

The Domino HTTP service configuration is stored in the notes.ini file located in your Domino data directory. To add index.php to the list of acceptable files, you need to modify this file.

Here’s how:

  1. Locate and open the notes.ini file using a text editor.

  2. Look for the section labeled [HTTP Files]. If this section doesn’t exist, create it.

  3. Add the following line under this section:

    IndexFiles=index.htm index.html index.php
    
  4. Save the file and close it.

After making these changes, restart your Domino HTTP service to apply them:

  1. Open a command prompt on your server.
  2. Type tell http stop and press Enter.
  3. Type tell http start and press Enter.

Testing the Changes

Once the service has restarted, try accessing URLs that only contain the directory name again, such as http://domain.com/wp/wp-admin/. If you’ve configured everything correctly, the server should now look for an index.php file in this directory before returning a 403 error.

Conclusion

Deploying PHP-based applications on non-standard servers like IBM Domino requires a deeper understanding of the underlying technologies. By configuring the notes.ini file to include index.php among the acceptable index files, you can ensure that your WordPress and Magento installations function correctly without requiring explicit filename references in every URL.

Remember, while the Domino server is highly configurable, it’s not designed for high-traffic PHP environments by default. As a best practice, consider migrating to a more modern LAMP stack if performance becomes a concern as your user base grows.

For further reading on optimizing PHP performance and improving WordPress security, I recommend checking out our in-depth guides at Laravel Company.

Happy coding! Let me know if you have any other questions.

Indexing Database Admin Configuration

Our network