Server Setup and Configuration

If you host your ADAM server on our cloud platform, you probably won’t need to worry about this section. However, if you’re hosting ADAM locally on your own server, it may be necessary to change some of the settings.

Setting up a “LAMP stack”

The minimum requirements for setting up a LAMP stack are the following:

We recommend running ADAM on an Ubuntu Server operating system with Ubuntu 24.04 LTS being the current recommended version. Ideally, this server should be a used only for ADAM. We cannot guarantee that other software will conflict with ADAM if running on the same server.

• Apache: 2.4
• PHP: 8.2

• PHP 8.4 will be a requirement for new servers from July 2025.

• MySQL: 8.0

In order for the server to receive updates, we require that the server is accessible from the greater internet via SSH. We will assist you in configuring the server to only allow certificate-based authentication with some other firewall rules in place.

Editing the configuration file

The configuration file is found in the ADAM source folder.

The following minimum settings are required:

• db_user: this is the username that ADAM will use to authenticate to the MySQL server.
• db_pass: this is the password that ADAM will use to authenticate to the MySQL server. If your password contains non-alphanumeric characters, you are advised to enclose the password in “double quotes”.
• db_host: this is the IP address or hostname of the MySQL server. In almost all instances, this will be 127.0.0.1, or localhost.
• db_name: this is the name of the MySQL database that ADAM will store your school’s data in.
• url: this is the URL from which your ADAM server will be accessed. Note carefully that this must be an HTTPS URL and be aware that it must be the same externally and internally from your LAN in order for the HTTPS certificate protection to work.

Any of the site settings can be overridden in the configuration file. This prevents an errant user from being able to change that setting either maliciously or accidentally.

To override a setting, you will need to know its setting code. This can be found with some HTML DOM inspection in your favourite web browser. In popular browsers such as Chrome and Firefox, this can be done by pressing “Ctrl + Shift + C” on your keyboard. This will open the Developer Tools panel. Move your mouse over, and click on, the field where the value is:

In the example above, the “Academic Subject Category” control has been selected. Note in the white panel at the bottom, the highlighted line which contains the text:

name="setting[academics]"

This is the part of relevance for us. In your configuration file, you could then write (taking note that the category ID for Academic subjects is 1):

settings[academics] = 1

For example. Note, please, the plural “settings” is required in the configuration file even though the name attribute makes use of the singular “setting”.