From fcf1856d6aacb067a4f40719967379903cc219ee Mon Sep 17 00:00:00 2001
From: sbpro <sbpro@noreply.code.itkan.io>
Date: Sat, 27 Dec 2025 00:34:37 +0000
Subject: [PATCH] Add `github-runner-deploy.md`

---
 github-runner-deploy.md | 83 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 83 insertions(+)
 create mode 100644 github-runner-deploy.md

diff --git a/github-runner-deploy.md b/github-runner-deploy.md
new file mode 100644
index 0000000..947b51a
--- /dev/null
+++ b/github-runner-deploy.md
@@ -0,0 +1,83 @@
+# 
+
+https://docs.gitea.com/usage/actions/act-runner
+
+## Binary Runner (for host/native workloads) 
+
+### Create dedicated user
+`sudo useradd -r -s /usr/sbin/nologin -m -c "Gitea Actions Runner" act_runner_native`
+
+### Download latest version (0.2.12)
+```
+VERSION=0.2.12
+sudo curl -sSLo /usr/local/bin/act_runner_native \
+  https://dl.gitea.com/act_runner/${VERSION}/act_runner-${VERSION}-linux-amd64
+sudo chmod +x /usr/local/bin/act_runner_native
+```
+
+### Create directories
+```
+sudo mkdir -p /etc/act_runner_native
+sudo mkdir -p /var/lib/act_runner_native
+```
+
+### Generate & edit config
+`/usr/local/bin/act_runner_native generate-config | sudo tee /etc/act_runner_native/config.yaml`
+
+```
+runner:
+  file: .runner
+  capacity: 1
+  labels:
+    - "native:host"
+    - "linux-host:host"
+    - "self-hosted:host"
+```
+The :host suffix tells the runner to execute jobs directly on the host instead of in Docker containers.
+
+### Register the runner
+```
+cd /var/lib/act_runner_native
+sudo -u act_runner_native /usr/local/bin/act_runner_native \
+  --config /etc/act_runner_native/config.yaml \
+  register \
+  --no-interactive \
+  --instance https://your-gitea.example.com \
+  --token YOUR_REGISTRATION_TOKEN \
+  --name native-runner \
+  --labels "native:host,linux-host:host,self-hosted:host"
+  
+sudo chown -R act_runner_native:act_runner_native /var/lib/act_runner_native
+sudo chown -R act_runner_native:act_runner_native /etc/act_runner_native
+```
+
+### Create systemd service
+`/etc/systemd/system/act_runner_native.service`
+
+```
+[Unit]
+Description=Gitea Actions Runner (Native/Host)
+Documentation=https://gitea.com/gitea/act_runner
+After=network.target
+
+[Service]
+ExecStart=/usr/local/bin/act_runner_native daemon --config /etc/act_runner_native/config.yaml
+ExecReload=/bin/kill -s HUP $MAINPID
+WorkingDirectory=/var/lib/act_runner_native
+TimeoutSec=0
+RestartSec=10
+Restart=always
+User=act_runner_native
+
+[Install]
+WantedBy=multi-user.target
+```
+
+```
+sudo systemctl daemon-reload
+sudo systemctl enable --now act_runner_native
+```
+
+## Docker Runner 
+
+WIP
\ No newline at end of file