Getting started with podman

---

This documentation is deprecated/obsolete. Lute v2 has been replaced by Lute v3, a full Python rewrite. Please see the Lute v3 manual which includes notes on installation. If you have Lute v2, you can easily migrate to v3. Thank you!

---

Podman (https://podman.io/) is an open source alternative for Docker. It is apparently lighter than Docker, but it doesn't yet have as full a community.

podman compose doesn't have the full feature parity with docker compose (specifically around .env files, per issue 80 in the Lute repo), so you'll need to edit the docker-compose.yml file for it to work:

version: "3.9"

services:
lute:
  build:
    context: ./
    dockerfile: Dockerfile
  restart: always
  environment:
    # Copy all of the .env file settings here and edit them as needed.
    - BACKUP_HOST_DIR=~/Backup/LuteBackup/
    - BACKUP_ENABLED=false
    - BACKUP_AUTO=yes
    - BACKUP_WARN=yes
    - BACKUP_COUNT=5
    - LOGIN_USERNAME=yourusername
    - LOGIN_PASSWORD=yourpassword
    - DB_FILENAME=/lute/data/lute.db
    - BACKUP_DIR=/lute/backup
    - DATABASE_URL=sqlite:///${DB_FILENAME}
    - APP_SECRET=not_secret_at_all
    - APP_ENV=prod
  env_file: .env
  ports:
    - 8000:8000
  volumes:
    # The host directories are mounted to the folders
    # specified in .env
    - ./data:/lute/data
    - ${BACKUP_HOST_DIR}:/lute/backup
  working_dir: /lute/public
  command: ["php", "-S", "0.0.0.0:8000"]

With this, you should be able to build and start the container:

podman-compose build
podman-compose up -d