Ilios
curriculum management for the health professions
Fork me on GitHub

Supported Browsers

Chrome   Firefox ESR   Edge   Safari   Safari iOS
Chrome   Firefox   Edge   Safari   Safari iOS
Latest ✔   Latest ✔   Latest ✔   Latest ✔   Latest ✔

Recommended Minimum System Requirements for Ilios 3 Installation (current as of 07/2024):

Standard production-grade Linux or Windows server with at least 500GB of storage available (for learning materials storage):

Ilios 3 uses a Symfony (PHP/SQL) backend to serve its API, so these tools and their required dependencies need to be installed before you can install the application itself. Here at the Ilios Project, we currently run and recommend running Ilios 3 using a “LAMP” (Linux/Apache/MySQL/PHP) technology stack with the following software packages and versions:

  • CentOS 7 - Any modern Linux should work, but we recommend Redhat (RHEL, CentOS, or Fedora) or Ubuntu
  • MySQL using the InnoDB database engine (v5.5 or later required, 5.7+ recommended)
  • PHP - In order to ensure the best security and performance of the application overall, we have adopted a policy of requiring the latest version of PHP for running Ilios (see PHP Version Policy)

PHP should be configured with a memory_limit setting of at least 386MB and have the following required packages/modules/extensions enabled:

  • php-mbstring - UTF-8 support
  • php-ldap - LDAP-connectivity support (when using LDAP)
  • php-xml - MeSH imports and report exports
  • php-pecl-apcu - caching
  • php-mysql - DB connectivity
  • php-mysqlnd - DB connectivity
  • php-pdo - DB connectivity
  • php-zip - native zip package [de]compression during the composer installation process

CentOS, RedHat, and Fedora Linux distributions come with SELinux installed and enabled by default. SELinux, aka “Security-Enhanced Linux”, greatly limits many actions typically allowed out-of-the-box on most Linux distros. If you seem to be having issues with your Ilios installation not working correctly and you have SELinux installed and enabled, we recommend you review your SELinux settings and/or check out our Troubleshooting section in the code documents.

You must enable URL-rewriting on your webserver. For those using Apache, this can be done by installing and enabling the mod_rewrite module. In IIS, this is handled via the Microsoft IIS URL Rewrite extension.

You will also need the Composer PHP package management tool. If you do not have it, you can learn about it and download it at https://getcomposer.org.

Several institutions have successfully deployed Ilios using Microsoft IIS on Windows as their webserver, but we do not recommend it as we do not have substantial experience with it ourselves, and we’ve only ever supported Ilios on Linux systems. That being said, if you MUST use IIS for Windows and are having trouble getting Ilios running properly, please contact the Ilios Project Support Team at support@iliosproject.org if you have any problems and we might be able to help you out!

The current deployment of Ilios uses its own native authentication system as the default, but may be switched via the configuration file to use shibboleth 2.4, CAS, or LDAP, if so desired.

For further information, please refer to the most recent readme, installation, and release notes available with the code at our Ilios GitHub page and Installation Instructions.