Skip to content
This repository was archived by the owner on Nov 12, 2023. It is now read-only.

Getting started raspberry pi

Jeff Zohrab edited this page Nov 11, 2023 · 3 revisions

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!


The content of this document was stolen with permission from comments made in GitHub. Thank you @99MengXin!

From https://www.raspberrypi.org/:

The Raspberry Pi is a low cost, credit-card sized computer that plugs into a computer monitor or TV, and uses a standard keyboard and mouse.

Platform

hostnamectl

Operating System: Debian GNU/Linux 11 (bullseye) Kernel: Linux 6.1.21-v8+ Architecture: arm64

Docker Installation

You need docker first, and it's super easy. Install Docker Engine on Debian | Docker Documentation

curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh

Lute Installation

Follow step by step, and you will not get lost. 🙂

Step 1: Go back to your home

cd

Step 2: Create the folders we need

mkdir ./Containers/lute/lute_release -p
mkdir ./Containers/lute/LuteBackup -p

Step 3: Go to the folder you just created

cd ./Containers/lute/lute_release

Step 4: Download lute from GitHub

wget https://github.com/jzohrab/lute/releases/download/<<VERSION_HERE>>/lute_release.zip

Step 5: Unzip the file

unzip lute_release.zip

Step 6: Remove the zip file

rm lute_release.zip

Step 7: Go back to your home

cd

Step 8: Go to your backup folder

cd ./Containers/lute/LuteBackup

Step 9: Check and copy your backup direction

pwd

Step 10: Go back to your home

cd

Step 11: Go back to lute folder

cd ./Containers/lute/lute_release

Step 12: Create the .env file for Lute configuration

cp .env.example.docker .env

Step 13: Open .env with nano editor

nano .env

Step 14: modify the BACKUP_HOST_DIR with the full path you got in Step 9. For example, if your username is pi, the path would be /home/pi/Containers/lute/LuteBackup

BACKUP_HOST_DIR=/home/pi/Containers/lute/LuteBackup

Step 15: Set BACKUP_ENABLED to true

BACKUP_ENABLED=true

Steps 16 to 18 are for users who want to use security (see Configuration - Security). If you don't need that, you can skip those steps.

Step 16: amend the LOGIN_USERNAME and LOGIN_PASSWORD to whatever you like, e.g. lute

LOGIN_USERNAME=lute
LOGIN_PASSWORD=lute

Step 17: Open security.yaml with nano editor

nano ./config/packages/security.yaml

Step 18: In Line 18 and 23, amend false to true

security: true

Step 19 is for users with previous installations -- if you don't have one, skip this step.

Step 19: Copy your data from previous version, e.g. lute 2.0.5

cp ../lute_release_OLD_VERSION/data/lute.db ./data/lute.db

Step 20: Build the docker image

docker compose build

Step 21: Start the container

docker compose up -d

Step 22: Open your favorite browser and go to [Your Pi's IP]:8000

Step 23: Enjoy and Cheers 🎉

Clone this wiki locally