Gitea Runner #2308

Activity

1. jellyhuck

   added

   task

   on Sep 24, 2026
2. MickLesk

   added

   Ready For Testing

   and removed

   task

   on Sep 29, 2026
3. github-actions commented on Sep 29, 2026

   

   github-actionsBot

   on Sep 29, 2026 – with GitHub Actions

   Contributor

   More actions

   The Gitea Runner script is ready for testing:

   bash -c "$(curl -fsSL https://github.com/community-scripts/ProxmoxVED/raw/main/ct/gitea-runner.sh)"
   

   Supports both Debian 13 and Alpine 3.24. The installer prompts for the OS or accepts var_os=alpine / var_os=debian.
   To register the runner, obtain a registration token in Gitea under Site Administration > Actions > Runners, then run: gitea-runner -c /etc/gitea-runner/config.yaml register --instance <URL> --token <TOKEN>.
   After registering, start the runner daemon service with systemctl start gitea-runner (Debian) or rc-service gitea-runner start (Alpine).
   Docker is installed and enabled by default for containerized workflow execution. Ensure nested virtualization is enabled on the LXC.

   Note: This is not in the official repo yet—it's just a dev version! After merging into ProxmoxVE, it will need to be recreated.

   Discord testing thread: https://discord.com/channels/1302816934508630047/1554452003214852158
4. fabianschmeltzer commented on Oct 28, 2026

   

   fabianschmeltzer

   on Oct 28, 2026

   More actions

   Title: Gitea Runner fails to start: cache.dir unset and $HOME not defined in systemd service

   Installation

   Installed using the [Gitea Runner Community Script](https://community-scripts.org/scripts/gitea-runner).
   Installed runner version: v5.2.4.

   Problem

   The runner remains offline in Gitea. The installed systemd service exits with status 1/FAILURE and repeatedly restarts.

   Error log

   Error: invalid configuration: cache.dir is unset and the user home directory could not be determined: $HOME is not defined
   gitea-runner.service: Main process exited, code=exited, status=1/FAILURE
   gitea-runner.service: Failed with result 'exit-code'.
   

   Relevant service configuration

   File: /etc/systemd/system/gitea-runner.service

   [Service]
   Type=simple
   ExecStart=/usr/local/bin/gitea-runner daemon --config /etc/gitea-runner/config.yaml
   WorkingDirectory=/var/lib/gitea-runner
   Restart=on-failure
   RestartSec=5s
   TimeoutStopSec=3h

   The installed unit specifies neither User= nor Environment=HOME=.... Setting WorkingDirectory= alone does not provide $HOME. With cache.dir unset, the runner fails during configuration validation.

   Expected behavior

   The installed service should provide the environment or explicit cache configuration required for the runner to start.

   Confirmed workaround

   Created /etc/systemd/system/gitea-runner.service.d/home.conf:

   [Service]
   Environment="HOME=/var/lib/gitea-runner"

   Then applied the change:

   systemctl daemon-reload
   systemctl restart gitea-runner

   The service subsequently remained active (running), logged declare successfully, and immediately picked up a workflow job.

   Suggested fix

   Ensure the installer configures a suitable HOME for the service or explicitly sets a writable cache.dir.
5. MickLesk commented on Oct 28, 2026

   

   MickLesk

   on Oct 28, 2026

   Member

   More actions

   Fixed in #3a85b87