Linux Installation

​

Installation Steps

• Ubuntu
• CentOS
• RHEL
• Oracle Linux

1

Run the Installation Script

SSH into your web server, ensure you’re using a user that has full sudo access, and run the command below:

curl -s -o curator.sh https://api.curator.interworks.com/scripts/linux_install.sh && chmod +x ./curator.sh && ./curator.sh

2

Retrieve Your Credentials

Locate your license key (sent from InterWorks) and open /var/www/curator_info.txt to retrieve your default administrator credentials.

3

Open the Installer

Open http://curatorexample.com/install.php in a browser - replacing curatorexample.com with your site’s URL. If you’re on the server you installed, you may also use localhost.This may be an IP address or computer name until your IT team sets up DNS.

4

Credentials

The installer will generate credentials for use during installation and will store them in a file in the installation directory (Default: /var/www/curator_info.txt or C:\InterWorks\Curator\curator_info.txt in Windows). You will need these credentials to complete the installation and to log in to the Curator backend after installation.

5

License Key

Enter your license key when prompted. If you do not have a license key, please contact InterWorks to obtain one.

6

Database Connection

You may be prompted to enter your database connection information if the installer is unable to automatically find the database for you.

7

Success

If the installation is successful, you will be redirected to your new Curator homepageUsing the same auto-generated credentials created in the install script above, you can log into the Curator backend which can be accessed from http://curatorexample.com/backend. If you’re on the server you installed, you may also use localhost. Keep in mind this may be an IP address or computer name until your IT team sets up DNS.

​

Custom Setup

curl -o curator.sh https://api.curator.interworks.com/scripts/linux_install.sh
chmod +x ./curator.sh
./curator.sh -f -h [database_host] -u [database_username] -p [database_password] -P [database_port] -d [database_name] -l [license_key] -s [persistent_storage_location] -v [curator_version]

• -h The database hostname Needed when using an external database host
• -u The database username Default: curator
• -p The database password Default: auto-generated password. Use this when you need to use a connection to a database for a user that has already been created with a specific password.
• -P The database port Default: 3306
• -d The database name Default: curator
• -l The License Key for your Curator installation. When performing a full installation, this is required.
• -s Path to a persistent storage location Container-based or distributed installations typically require this.
• -v Sets the version of Curator to install. Default: most recent version.

• -f Full Installation, this flag is required in most custom setups to avoid the in-browser installer.

​

Key File Locations

​

Ubuntu 22.04 / 24.04

• Webroot: /var/www/html
• Environment file: /var/www/html/.env
• PHP.ini (Apache): /etc/php/8.3/apache2/php.ini
• PHP.ini (FPM): /etc/php/8.3/fpm/php.ini

​

RHEL 9 / CentOS 9 / Oracle Linux 9+

• Webroot: /var/www/html
• Environment file: /var/www/html/.env
• PHP.ini: /etc/opt/remi/php83/php.ini

​

Environment Configuration

​

Log Locations

• Application Log: /var/www/html/storage/logs/system-YYYY-MM-DD.log
• PHP Installer Log: /var/www/html/assets/install.log
• Shell Installer Log: ~/iw_install.log

​

AWS EC2 Process

​

Network Whitelist Requirements

​

RHEL/CentOS/Oracle Linux Systems

• InterWorks API
  • api.curator.interworks.com
• EPEL Repository
  • dl.fedoraproject.org
  • download.fedoraproject.org (covers mirrors.fedoraproject.org)
• Remi Repository (PHP packages)
  • *.remirepo.net (covers rpms.remirepo.net, repo.remirepo.net, mirrors.remirepo.net)
• Base RHEL/CentOS Repositories
  • *.centos.org (covers vault.centos.org, mirror.centos.org)
  • download.redhat.com
  • cdn.redhat.com
• Oracle Linux Repositories (Oracle Linux only)
  • yum.oracle.com
  • oss.oracle.com
• CDN Networks
  • *.akamaiedge.net (covers *.akamaitechnologies.com - same Akamai network)

​

Ubuntu Systems

• InterWorks API
  • api.curator.interworks.com
• Ubuntu Repositories
  • *.archive.ubuntu.com (covers archive.ubuntu.com, us.archive.ubuntu.com, gb.archive.ubuntu.com, etc.)
  • security.ubuntu.com
  • ports.ubuntu.com
  • changelogs.ubuntu.com
• Launchpad PPAs (for ondrej/apache2 and ondrej/php)
  • *.launchpad.net (covers ppa.launchpad.net, launchpad.net)
  • ppa.launchpadcontent.net
  • keyserver.ubuntu.com

​

Testing Connectivity

curl -sS -w '\nHTTP status: %{http_code}\n' https://api.curator.interworks.com/widget/latest

$('#iw_latest_widget_wrapper').html('<div class="iw-latest-container">    <span>2026.08-03</span></div>');