Installation
#
Install StrategiesWe offer three installation strategies for Manifold:
- Install from OS package
- Install with Docker images
- Install from source
For package installations, we distribute packages for Ubuntu (18.x and 20.x) and Redhat/CentOS (el7 and el8). The package will install and configure every service needed to run Manifold. You will need root access to the host in order to install Manifold from these packages. This is the fastest, easiest way to install Manifold, but it also is the most intrusive and gives you the least control over the installation. That said, for users who are not familiar with the Manifold technology stack (Rails, Node, ElasticSearch, PostgreSQL, Redis, and Nginx), package installation will be the fastest and simplest approach.
When Manifold is installed using Docker, each service runs in its own Docker container and the services are coordinated using Docker compose.
We're still working on documentation for installing Manifold from source. For now, this is not an officially supported installation method, but we hope to provide guidance soon.
note
Manifold is a new piece of software, and we're working hard to refine and improve the installation process. If you run into problems, please don't get frustrated. Let us know in Slack (join here) or report an issue. It's very important to us that Manifold be easy to install, and we appreciate your help as we improve this process.
#
Install InstructionsSelect the strategy that makes sense for your organization to see the corresponding instructions.
info
The current stable Manifold version is v8.1.1. All releases can be downloaded from the downloads page.
#
Package InstallThe most recent version of Manifold is v8.1.1.
Support for Ubuntu16 was discontinued with the release of Manifold v6. Support for Ubuntu18 was discontinued with the release of Manifold v8.
#
1. Download the PackageShell into the server as root and download the most recent package.
- Ubuntu22
- Ubuntu20
- CentOS 8
- CentOS 7
#
2. Install the Package- Ubuntu22
- Ubuntu20
- CentOS 8
- CentOS 7
#
3. Apply Minimal ConfigurationThe package installer creates a file at /etc/manifold/manifold.rb
. Use this file to configure and manage the various services that Manifold is composed of. After changing this file, you’ll need to run sudo manifold-ctl reconfigure from the command line so that Manifold picks up the changes and regenerates various configuration files based on the new settings.
For now, let’s just make sure Manifold is on the right domain. Open /etc/manifold/manifold.rb
in your preferred text editor (nano, vi, etc.) and look for the external_url setting near the top of the file. Set this to the fully qualified domain name of your Manifold installation, then reconfigure Manifold with the following command. You may be prompted to accept the license. You can scroll through the licenses by pressing space, or “q” to exit the license view. You will need to accept the licenses before proceeding with the installation.
Once this process is complete and you've restarted Manifold, visit the fully qualified domain name in your browser. You should see an empty Manifold home page.
#
4. Access the BackendAll content stored in Manifold—texts, projects, authors, resources, users, etc—is managed through Manifold’s backend interface. The backend is available at the /backend
path. For example, if your domain name was your-manifold-domain.tld, you’d access the backend at http://your-manifold-domain.tld/backend
.
Before you can login to the backend, you will need to make an administrative user. Manifold exposes Rake commands provided by the API Rails application by way of a manifold-api
executable located at /usr/local/bin/manifold-api
. This executable includes a command for creating an admin user. Call this command as follows:
Substitute your email, password, first and last into the command above. If the command succeed, Manifold will let you know. For example:
Once you’ve created an admin user, click on the avatar icon in the top right corner of the Manifold frontend to login. After logging in successfully, you will see an “admin mode” button in the header. Click the admin mode button to access the backend.
#
Docker InstallStarting with version 4.0, we publish Docker images alongside our OS packages. These images are published under the manifoldscholarship organization on hub.docker.com. The Manifold team is happy to accept pull requests and are open to suggestions as to how we can improve our Docker support.
The following instructions assume that you've intalled docker and can run both
docker
and docker-compose
from the command line.
To begin running Manifold on Docker, clone our docker-compose repository:
The docker-compose.yml file in this repository includes all the services that Manifold needs to run. For more complex deployments, feel free to use this files as a starting point and modify as needed.
Before spinning up the containers, modify environment/manifold.env so that it contains the correct IP or domain name for your server. Unless you're just running these locally, you'll need to replace 127.0.0.1 from the following env vars:
From within that git repository, create and start Manifold containers:
Access the site in your browser. Be patient, as it might take a minute for services to start.
Tail container log output (ctrl + c to stop)
Restart Manifold containers
Stop Manifold containers
Stop and remove Manifold containers
Access the Rails (Manifold API Backend) console
Replace console
in the above command with other Manifold rake commands. These
commands are the same commands that are available in the Omnibus packages, and
are documented here
Create an admin user
With some terminal configurations don't forget to escape [
and ]
like \[
.
#
Source Installnote
This section is still a work in progress. Check back soon for instructions on installing from source.