Skip to main content

How to install Praise on Digital Ocean

The installation process requires only basic server knowledge and takes about 30 minutes. We have verified the installation on Digital Ocean but should with little or no modifications work on any Ubuntu server.

Step 1 โ€“ Create a Dropletโ€‹

When writing this guide we used the following Droplet config:

  • Ubuntu 20.04 (LTS) x64
  • 80 GB disk
  • 4 GB memory

Praise might well run on a smaller setup as well, that is yet to be determined though.

Step 2 โ€“ Configure a hostnameโ€‹

The webserver hosting the Praise dashboard automatically generates https certificates and therefore needs be configured with a hostname. Configure an A RECORD at your DNS provider that points to the Droplet IP.

For example, the Commons Stack Praise DNS setup:

TYPEDOMAIN NAMEIPTTL
Apraise.commonsstack.org167.172.63.12530 min

Step 3 โ€“ Use ssh to access Dropletโ€‹

ssh root@xxx.xxx.xxx.xxx

This guide installs Praise under the root user, making no effort to secure the server. The following steps are optional but highly recommended:

Step 4 โ€“ Install Dockerโ€‹

The Praise database runs on MongoDB, managed by Docker.

Complete step 1-2 of the installation guide: How To Install and Use Docker on Ubuntu 20.04

  • Step 1 โ€” Installing Docker
  • Step 2 โ€” Executing the Docker Command Without Sudo
info

If ou are using ufw as firewall, additional configuration of Docker is needed.

Step 5 โ€“ Install Docker Composeโ€‹

Docker compose is utility for configuring and running Docker containers. Praise requires docker compose v2 to be installed.

Complete step 1 in the installation guide: How To Install and Use Docker Compose on Ubuntu

  • Step 1 โ€” Installing Docker Compose

Step 6 โ€“ Pull Praise repository from GitHubโ€‹

Clone the Praise repository from GitHub:

git clone https://github.com/CommonsBuild/praise.git

Step 7 โ€“ Create a Discord botโ€‹

The Discord bot used to interact with Praise is created in the Discord developer dashboard. Take note of the various bot ids during bot creation as they will be used in the next step.

Step 8 โ€“ Configure environmentโ€‹

Run the Praise setup script to configure the runtime environment:

cd praise
bash setup.sh

Step 9 โ€“ Start Praiseโ€‹

bash start.sh

Finished ๐ŸŽ‰โ€‹

Your praise system should be up and running!