Configuration File

SmallBlock uses a configuration file named settings.yaml located in your project root. Environment variables can override these settings.

Example

database:
  engine: postgresql
  name: smallblock
  user: sb_user
  password: secure_password
  host: localhost
  port: 5432

debug: false
static_root: /srv/smallblockcms/static
allowed_hosts:
  - smallblockcms.com

Key Settings

Setting

Description

database.engine

Specifies the database backend (postgresql or mysql).

debug

Enables detailed error pages and logging.

allowed_hosts

List of valid hostnames for the application.

static_root

Filesystem path where static assets are collected.