README.md

Friday Deployment

Server (systemd on Linux)

# Create a dedicated user
sudo useradd -r -s /bin/false friday

# Copy the service file
sudo cp friday-server.service /etc/systemd/system/

# Enable and start
sudo systemctl daemon-reload
sudo systemctl enable friday-server
sudo systemctl start friday-server

# Logs
journalctl -u friday-server -f

Client (User Session)

# Install as a user-level systemd service
mkdir -p ~/.config/systemd/user
cp friday-client.service ~/.config/systemd/user/

systemctl --user daemon-reload
systemctl --user enable friday-client
systemctl --user start friday-client

# Logs
journalctl --user -u friday-client -f

Recovery

Both services use Restart=always — if Friday crashes, systemd restarts it within 5 seconds (server) or 3 seconds (client). The StartLimitBurst prevents restart storms.

Backup

The server's BackupManager creates daily backups to data/backups/. To trigger a manual backup:

from server.improvement.backup import BackupManager
from server.config import get_server_settings
import asyncio

async def backup():
    bm = BackupManager(get_server_settings())
    path = await bm.run_backup()
    print(f"Backup at: {path}")

asyncio.run(backup())