autokanban/PRODUCTION.md

Production Deployment Checklist

Before Going Live

1. Environment Configuration

• Copy .env.example to .env on the Pi

• Set a strong ADMIN_PASSWORD in .env

• Generate and set SESSION_SECRET in .env:

  # On the Pi, generate a secure random key:
  openssl rand -hex 32
  # Copy the output and add to .env as SESSION_SECRET
  

2. Security

• Ensure .env is in .gitignore (already done)
• Never commit .env file to git
• Change default admin password from example

3. Hardware Setup

• Thermal printer connected via GPIO (Yellow to Pin 8, GND to Pin 6)
• External 9V power supply for printer
• Verify printer works: echo -e "\x1B\x40Test\n\n\n" > /dev/serial0
• Serial port enabled: ls -la /dev/serial0 should point to ttyAMA0

4. Service Configuration

• Run ./setup_service.sh to enable autostart
• Verify service is running: sudo systemctl status autokanban
• Test autostart by rebooting: sudo reboot

5. Network Access

• Set hostname to autokanban: sudo hostnamectl set-hostname autokanban
• Access app at http://autokanban.local:8000
• Verify 124 Hub link in header works

6. Production Settings Verified

• ENABLE_PHYSICAL_PRINTER = True in app/main.py
• Debug print statements removed
• Session secret loaded from environment variable
• Service runs without --reload flag

7. Testing

• Submit a test task
• Approve task as admin
• Print task and verify:
  • Preview image shows on website
  • Physical card prints with formatting
  • Icon appears correctly
  • Text is readable (larger fonts)
• Test "Erneut drucken" (reprint) function
• Test service restart: sudo systemctl restart autokanban

8. Monitoring

• Check logs: sudo journalctl -u autokanban -f
• Verify no errors in startup
• Test graceful shutdown: sudo systemctl stop autokanban

Post-Deployment

Regular Maintenance

# Update code
cd ~/autokanban
git pull
sudo systemctl restart autokanban

# View logs
sudo journalctl -u autokanban -n 100

# Check service status
sudo systemctl status autokanban

# Backup tasks
cp data/tasks.json data/tasks.json.backup

Troubleshooting

# Service won't start
sudo journalctl -u autokanban -n 50

# Printer not working
ls -la /dev/serial0
stty -F /dev/serial0

# Check if port is accessible
curl http://localhost:8000

# Restart service
sudo systemctl restart autokanban

Current Configuration

• Port: 8000
• Hostname: autokanban.local
• Access URL: http://autokanban.local:8000
• Printer: GPIO serial (/dev/serial0, 19200 baud)
• Service: Systemd with autostart enabled
• Data: JSON file at data/tasks.json
• Previews: PNG files in out/

---

Last updated: 2025-11-20