CLIO Installation

Overview

CLIO is a web-based application, which means that it needs to be installed on the Local Web Development Environment.  There is no setup process for databases, meaning that the CLIO web application files can be dragged directly to the applicable web server folder and access without installation.  Different Operating Systems have different locations for their hosted content. 

First, we need to download the CLIO web application package which is available at https://cliomuseums.org/?section=download.  Navigate to the folder where the “preview.zip” package was downloaded and extract it.  Depending on your software defaults, this process may be slightly different.  If you encounter problems, you can right-click on the “preview.zip” file and select “Open With…” then choose “Windows Explorer”.

Once you have navigated into the ZIP file, open the “v0.0.9 - Preview Release” folder.  Next, right-click on the “CLIO” folder and select “Copy”.

Now we need to navigate to the Web Server hosted directory listed above.  For Windows, the default location is “C:\xampp\htdocs”.  Once you’re in this folder, you can paste the “CLIO” folder here.

Download

First, we need to download the CLIO web application package which is available at https://cliomuseums.org/?section=download.  Navigate to the folder where the “preview.zip” package was downloaded and extract it.  Depending on your software defaults, this process may be slightly different. 

Installation

Windows

You can right-click on the “preview.zip” file and select “Open With…” then choose “Windows Explorer”.

Once you have navigated into the ZIP file, open the “v0.0.9 - Preview Release” folder.  Next, right-click on the “CLIO” folder and select “Copy”.

Now we need to navigate to the Web Server host directory.  If you follow the Creating a Local Web Development Environment guide, the default location is “C:\xampp\htdocs”.  Once you’re in this folder, you can paste the “CLIO” folder here.

MacOS

You can right-click on the “preview.zip” file and select “Open”. MacOS will extract the archive into the same folder as the zip file.

After extracting the zip file, open the “v0.0.9 - Preview Release” folder.  Next, right-click on the “CLIO” folder and select “Copy”.

Now we need to navigate to the Web Server host directory.  Open XAMPP. We will need to go to the “Volumes” tab.  This will allow us to mount the files used by the web server as a remote drive so we can make changes to the files that are being hosted.

Click “Mount” beside the first data volume, which should be “/opt/lampp”.  This will make the volume appear in Finder so we can alter files.

The web server’s contents are stored in /lampp/htdocs/.  

Once you're in this folder, you can paste the “CLIO” folder here.

Linux

This section could use more detail. You can help by expanding it.