Installing Manifold on Ubuntu: Download & Install Package
The most recent Manifold Ubuntu release is 2.1.1. To install previous releases, grab the appropriate URL from the downloads page.
The following instructions have only been tested on Ubuntu 16 and Ubuntu 18 hosts. We recommend installing Manifold on Ubuntu 18. Your mileage will almost certainly vary if you attempt to install Manifold on a different Debian based distribution.
Manifold should be installed on a virtual or physical server with at least 1 CPU and 6 GB of RAM (8GB preferred).1 We’ve had good luck installing Manifold on Google Cloud Compute instances, AWS EC2 instances, and Digital Ocean droplets.
You will need to have root access to the server and the ability to shell into the server.
Your server should have a fully qualified domain name (FQDN). If the hostname is setup correctly, the installer should detect it and configure manifold accordingly. If it’s not, you can set the hostname manually in
/etc/manifold/manifold.rband reconfigure the application. Reconfiguration is discussed below.
1. Download the Package
Shell into the server as root and download the most recent package.
On Ubuntu 16:
cd ~ curl -O https://storage.googleapis.com/manifold-dist/ubuntu16/manifold_2.1.1-1_amd64.deb
On Ubuntu 18:
cd ~ curl -O https://storage.googleapis.com/manifold-dist/ubuntu18/manifold_2.1.1-1_amd64.deb
2. Install the Package
On Ubuntu 16 and Ubuntu 18:
cd ~ dpkg -i manifold_2.1.1-1_amd64.deb
3. Apply Minimal Configuration
The 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:
Once this process is complete, visit the fully qualified domain name in your browser. You should see an empty Manifold home page.
If everything looks good, proceed to the next step.
1 We advise against attempting to install Manifold in a shared hosting environment for security and stability reasons. Manifold consists of a number of distinct services, each of which requires RAM to function correctly. On a small VM with less than 6GB of RAM, you will likely need to enable swap memory or risk consuming all available memory.