Quick Setup Step 2

Install SmallBlock

This step installs the SmallBlock CMS package and verifies the installation.

Note

Ensure you’ve completed Step 1 — Install Python and Dependencies before continuing.

Overview

SmallBlock is distributed via PyPI and can be installed globally or in a virtual environment. For most deployments, system-wide installation with pip3 is fine.

Debian / Ubuntu (22.04+)

sudo apt update
sudo apt install -y python3-pip
sudo pip3 install smallblockcms

Verify:

smallblock --version

RHEL / CentOS / AlmaLinux / Rocky / Stream 9–10

sudo dnf install -y python3-pip
sudo pip3 install smallblockcms

If you installed development libraries in Step 1, you can safely compile any optional dependencies.

Verify:

smallblock --version

Fedora

sudo dnf install -y python3-pip
sudo pip3 install smallblockcms
smallblock --version

openSUSE Leap / Tumbleweed

sudo zypper install -y python310-pip
sudo pip3 install smallblockcms
smallblock --version

Arch Linux

sudo pacman -Syu --noconfirm python-pip
sudo pip3 install smallblockcms
smallblock --version

Post-Installation Verification

If installation succeeds, the command below should print a version number:

smallblock --version

Example output:

SmallBlock CMS 1.2.0 (2025-11-05)

Next Step

Proceed to Step 3 — Configure Database to set up PostgreSQL or MariaDB.