Installing Manifold on Reclaim Cloud

Difficulty: Intermediate
Estimated Cloudlet Usage: 24

Manifold is an intuitive, collaborative, open-source platform for scholarly publishing. The software provides an easy method for academic publishers to move their catalog online and provide a powerful reading, annotation, and community experience for everyone. Learn more about the project at https://manifoldapp.org

This guide will walk you through the process of installing Manifold using Docker on Reclaim Cloud. While the install process is relatively painless, we want to highlight that Manifold also offers paid services that range from maintenance and update support to training. These services are a great way to ensure the long term sustainability of the open source project as well as get timely support on any issues you may have with your instance of Manifold. Now let’s get started.

  1. After logging into Reclaim Cloud you’ll create a new Docker environment by opening the Marketplace and searching Docker CE.

Screen Shot 2020-07-12 at 9.13.45 AM

  1. Select the default standalone engine and choose your environment name then click Install.

  1. The Docker engine install often adds a public IPv4 but we won’t need it so edit the topology of the environment and ensure the number of IPs is 0 and go ahead and turn on the shared SSL certificate.

  1. You will need to connect with the web shell console or alternatively you can setup an SSH keypair and connect via your own Terminal to the SSH Gate SSH Access | Jelastic Dev Docs. For this guide we’ll use the web console.

  1. Run the command git clone https://github.com/ManifoldScholar/manifold-docker-compose.git && cd manifold-docker-compose;

  2. Edit the file environment/manifold.env to update the domain and URLs at the top of the file to match your environment domain. In this case I have removed port 4000 and updated the URLs to use https. Keep SSL set to false here since it’s handled at the environment level.

  1. Edit docker-compose.yml and remove the comment for port 80 (the # symbol in front of it)

  1. Run the command MANIFOLD_TAG=v5.0.0 docker-compose up -d and grab yourself a cup of coffee while the install happens.

  1. Once the install is complete within a few minutes Manifold should be up and running at the domain.

  1. The final step is to add an admin user to the system which is done in the shell console. Use the following command replacing your own email, password, and first/last name:

docker exec -it manifold-docker-compose_api_rails_1 rails manifold:user:create:admin['professorawesome@fancyschool.edu','S3cureP@$$word','First-Name','Last-Name']