autostart

SERVICE_README.md

@@ -0,0 +1,104 @@
+# AutoKanban Service Setup
+
+This directory contains files to run AutoKanban as a system service that starts automatically on boot.
+
+## Quick Setup (Raspberry Pi)
+
+1. **Run the setup script:**
+
+   ```bash
+   cd ~/autokanban
+   chmod +x setup_service.sh
+   ./setup_service.sh
+   ```
+
+2. **The app will now start automatically on boot!**
+
+## Service Management Commands
+
+```bash
+# Check if service is running
+sudo systemctl status autokanban
+
+# Stop the service
+sudo systemctl stop autokanban
+
+# Start the service
+sudo systemctl start autokanban
+
+# Restart the service
+sudo systemctl restart autokanban
+
+# View live logs
+sudo journalctl -u autokanban -f
+
+# View recent logs
+sudo journalctl -u autokanban -n 50
+
+# Disable autostart on boot
+sudo systemctl disable autokanban
+
+# Enable autostart on boot
+sudo systemctl enable autokanban
+```
+
+## Manual Service Installation
+
+If the setup script doesn't work, install manually:
+
+```bash
+# Copy service file
+sudo cp autokanban.service /etc/systemd/system/
+
+# Edit paths if needed
+sudo nano /etc/systemd/system/autokanban.service
+
+# Reload systemd
+sudo systemctl daemon-reload
+
+# Enable and start
+sudo systemctl enable autokanban
+sudo systemctl start autokanban
+```
+
+## Updating the App
+
+After pulling new code:
+
+```bash
+cd ~/autokanban
+git pull
+sudo systemctl restart autokanban
+```
+
+## Troubleshooting
+
+**Service won't start:**
+
+```bash
+# Check logs for errors
+sudo journalctl -u autokanban -n 50
+
+# Check Python path
+which python
+# Update ExecStart in service file if needed
+```
+
+**Permission issues:**
+
+```bash
+# Make sure user is in dialout group (for printer)
+sudo usermod -a -G dialout $USER
+
+# Reboot for group changes to take effect
+sudo reboot
+```
+
+**Port already in use:**
+
+```bash
+# Check what's using port 8000
+sudo lsof -i :8000
+
+# Kill the process or change port in start_app.py
+```