svandragt / lamb

Literally Another Micro Blog
https://svandragt.github.io/lamb/
MIT License
6 stars 0 forks source link
microblog php

Lamb made out of circuitry

Lamb - Literally Another Micro Blog.

Barrier free super simple blogging, self-hosted.

Getting started

# checkout project
git clone https://github.com/svandragt/lamb.git
cd lamb

Lamb can be run locally with the builtin PHP webserver, here are two ways to set this up:

  1. Devbox, OR
  2. locally install PHP 8.1 and composer.

1. Devbox

devbox shell
composer install

2. Locally installed PHP and Composer

# Install required system packages, for example on Debian Linux derivates like Ubuntu
sudo apt update
sudo apt install php8.2 php8.2-gettext php8.2-mbstring php8.2-sqlite3 php8.2 php8.2-xml composer

# install project packages
composer install

Run Lamb

To Run:

LAMB_LOGIN_PASSWORD=$(php make_password_hash.php hackme) composer serve

Change hackme to something more secure, this is the /login password!

Support for Docker, Caddy and NGINX is also provided.

Site Configuration (optional)

Add a src/config.ini file with the following contents and update any of the following lines after uncommenting them:

;author_email = joe.sheeple@example.com
;author_name = Joe Sheeple
;site_title = My Microblog
;404_fallback = https://my.oldsite.com

Screenshots

An example blog with the default theme: Demo Lamb instance

Dropping images into a post ala GitHub: Drag and drop image demo

Friction free post deletion: Friction free post deletion (video)

Philosophy

Built with Devbox