105 lines
1.8 KiB
Markdown
105 lines
1.8 KiB
Markdown
|
# 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
|
||
|
|
```
|