Prepare your environment

Get ready to…

• Install any tools and set up prerequisites that you will use to run Paideia LMS

Get the prerequisites you need

Operating System

Paideia LMS runs on macOS (ARM64 or x64) or Linux (ARM64 or x64). Make sure you have access to a compatible operating system.

Terminal

You will use a command line (terminal) to download, install, and run Paideia LMS, and to configure your environment.

You can access the command line through a local terminal program for your operating system. Common applications include Terminal (macOS/Linux), Command Prompt (Windows), and Termux (Android). One of these will probably already be on your machine.

PostgreSQL Database

Paideia LMS requires a PostgreSQL database. You’ll need either:

• A local PostgreSQL installation
• Access to a remote PostgreSQL database
• Docker Compose (which includes PostgreSQL)

To check if you have PostgreSQL installed locally, run:

psql --version

# Example output
psql (PostgreSQL) 18.0

If you don’t have PostgreSQL installed, you can:

• Install PostgreSQL locally
• Use Docker Compose (which we’ll cover in the installation steps)
• Use a cloud PostgreSQL service

S3-Compatible Storage

Paideia LMS requires S3-compatible storage for file storage. You’ll need either:

• MinIO (S3-compatible storage) - included with Docker Compose
• An S3-compatible service (AWS S3, DigitalOcean Spaces, etc.)
• Local MinIO installation

Code Editor (Optional)

While not required, a code editor can be helpful for editing configuration files.

We’ll use…

This tutorial will use VS Code, but you can use any editor for your operating system.

1. Download and install VS Code or another code editor of your choice (optional).

Test your knowledge

Which of the following is…

1. A database system required by Paideia LMS?

   1. MySQL

   2. PostgreSQL

   3. MongoDB

   Submit

2. Storage system required by Paideia LMS?

   1. Local file system

   2. S3-compatible storage

   3. Google Drive

   Submit

3. An application for running commands?

   1. VS Code

   2. Terminal

   3. Web browser

   Submit

Checklist for moving on

• I can access the command line in a terminal.
• I have PostgreSQL available (or will use Docker Compose).
• I have S3-compatible storage available (or will use Docker Compose).
• I have a code editor like VS Code (optional).

Resources

• PostgreSQL Documentation external — official PostgreSQL documentation

• MinIO Documentation external — MinIO S3-compatible storage documentation