Red Hat/Cent OS

If you notice any mistakes that need to be corrected, please reach out on Discord!


Petio supports two ways of connecting to a Mongo Database instance, locally or remote. We recommend the locally hosted MongoDB option.

MongoDB Locally

  • Configure the package management system (yum)

  • Create a /etc/yum.repos.d/mongodb-org-4.4.repo file so that you can install MongoDB directly using yum:

sudo nano /etc/yum.repos.d/mongodb-org-4.4.repo
  • Paste in the nano / terminal window:

name=MongoDB Repository
  • Press: "CTRL + O" to save and "CTRL+X" to exit.

  • To install the latest stable version of MongoDB, issue the following command:

sudo yum install -y mongodb-org
  • Start MongoDB:

sudo systemctl start mongod
  • Verify that MongoDB has started successfully:

sudo systemctl status mongod
  • To make sure MongoDB starts after restart use:

sudo systemctl enable mongod

MongoDB Remotely

  • Register for Atlas here.

  • Create a free cluster.

  • Change the provider or region if you need to. It may take some time to create the cluster.

  • After the cluster is made, click on connect and select MongoDB Compass and follow the instructions on screen.

Installing Petio

  • Create a user for Petio:

sudo useradd -M --shell=/bin/false petio
  • Make a directory for Petio:

sudo mkdir /opt/Petio
  • Download the latest version of Petio:

sudo wget -O
  • Extract Petio to the directory we just made:

sudo unzip -d /opt/Petio
  • Change ownership of the directory for Petio:

sudo chown -R petio:petio /opt/Petio
  • Create the petio service with systemd:

sudo vi /etc/systemd/system/petio.service
Description=Petio a content request system
  • Reload systemd:

sudo systemctl daemon-reload
  • Start Petio:

sudo systemctl start petio

Once you've completed theses steps, you can navigate to http://<hostname>:7777 to start configuring Petio.