Quick Setup Step 4¶

Run the Development Server¶

With Python, dependencies, and your database ready, this step starts SmallBlock CMS for the first time.

Note

The development server is for local use only. For production deployments, refer to Deployment.

—

Run the SmallBlock initializer to create a project directory.

smallblock init mysite
cd mysite

This creates a minimal layout:

mysite/
├── settings.yaml
├── manage.py
├── templates/
└── content/

—

Prepare the schema:

smallblock migrate

Expected output:

✔ Applied 12 migrations
✔ Database schema is up to date

—

Start the built-in web server on port 8000.

smallblock runserver 0.0.0.0:8000

smallblock runserver 0.0.0.0:8000

smallblock runserver 0.0.0.0:8000

smallblock runserver 0.0.0.0:8000

smallblock runserver 0.0.0.0:8000

(All distributions use the same command; differences are only in service management.)

—

Visit the URL shown in the terminal—usually:

You should see the SmallBlock CMS welcome page.

Stop the server with Ctrl +C.

—

You can bind to a custom host or port:

smallblock runserver 8080
smallblock runserver 192.168.1.10:9000

—

—

Another process (e.g., Nginx) is listening on :8000.

sudo lsof -i :8000
sudo kill <PID>

Re-run migrations:

smallblock migrate --force

—

You now have a working local instance. For production deployment, see Production Deployment Guide.