kekbot.js/GITEA-DEPLOY.md

Gitea Workflow Deployment to NAS

This guide explains how to set up the Gitea workflow to deploy Kekbot to your NAS via SSH.

Prerequisites

1. Docker and Docker Compose must be installed on your NAS
2. SSH access enabled on your NAS with password authentication

Setup Instructions

1. Add SSH Password Secret to Gitea

1. Go to your Gitea repository
2. Navigate to Settings → Secrets (or Actions → Secrets)
3. Add a new secret named NAS_SSH_PASSWORD
4. Set the value to your NAS user password (hllywluis)

2. Verify NAS Configuration

Ensure your NAS has:

• Docker installed
• Docker Compose installed
• SSH server running on port 22
• Password authentication enabled for SSH

3. Test SSH Access (Optional)

Before running the workflow, you can test SSH access:

ssh hllywluis@luis-nas.lan

Workflow Configuration

The workflow file is located at .gitea/workflows/deploy-nas.yml

How It Works

1. Build: Builds the Docker image locally using Docker Buildx
2. Save: Saves the Docker image as a tar archive
3. Transfer: Uses sshpass to SSH into your NAS and copy files
4. Deploy: Loads the Docker image and runs docker-compose up -d

Manual Trigger

You can manually trigger the deployment by:

1. Going to your Gitea repository
2. Navigating to Actions
3. Selecting the Deploy to NAS workflow
4. Clicking Run workflow

Troubleshooting

SSH Connection Failed

If the workflow fails with SSH connection issues:

• Verify NAS_SSH_PASSWORD secret is set correctly
• Check that the NAS is reachable at luis-nas.lan
• Ensure SSH password authentication is enabled on the NAS

Docker Errors

If Docker fails on the NAS:

• Verify Docker is running: docker ps
• Check Docker Compose: docker-compose --version
• Review logs: docker-compose logs

Permission Issues

The workflow uses the hllywluis user. If you need a different user:

1. Update the hllywluis@luis-nas.lan in the workflow file
2. Adjust the /mnt/kCloud/Home/hllywluis/kekbot directory permissions accordingly