VPS पर सेल्फ-होस्टेड GitHub Actions runner कैसे सेट करें

VPS पर एक सेल्फ-होस्टेड GitHub Actions runner रजिस्टर करें और उसे सेवा के रूप में इंस्टॉल करें: non-root उपयोगकर्ता के रूप में runner डाउनलोड करें, अपने repo टोकन से रजिस्टर करें, svc.sh चलाएँ ताकि यह रीबूट के बाद बचा रहे। कॉपी-पेस्ट कमांड।

एक सेल्फ-होस्टेड runner आपको गरम कैश के साथ फ़्लैट-कॉस्ट CI देता है — कोई प्रति-मिनट बिलिंग नहीं, आपका टूलचेन, आपकी मशीन। यह न्यूनतम सेटअप गाइड है; सेल्फ-होस्टिंग GitHub-होस्टेड मिनटों से क्यों बेहतर है और Docker-जॉब विवरण के लिए देखें पूरी गाइड और GitHub Actions के लिए VPS उपयोग-केस।

1. एक non-root उपयोगकर्ता बनाएँ (runner root को अस्वीकार करता है)

adduser --disabled-password --gecos "" runner
su - runner

2. runner डाउनलोड करें

GitHub में: Settings → Actions → Runners → New self-hosted runner → Linux, जो आपको सटीक डाउनलोड और एक बार का टोकन देता है। फिर:

mkdir actions-runner && cd actions-runner
curl -o actions-runner-linux-x64.tar.gz -L \
  https://github.com/actions/runner/releases/latest/download/actions-runner-linux-x64.tar.gz
tar xzf actions-runner-linux-x64.tar.gz

3. इसे अपने repo के साथ रजिस्टर करें

./config.sh --url https://github.com/YOUR_ORG/YOUR_REPO --token YOUR_TOKEN

4. सेवा के रूप में इंस्टॉल करें (रीबूट के बाद बचता है)

./run.sh को टर्मिनल में न चलाएँ — इसे इंस्टॉल करें:

sudo ./svc.sh install runner
sudo ./svc.sh start
sudo ./svc.sh status

runner अब GitHub UI में Idle दिखता है और उसे लक्षित करने वाले जॉब उठा लेता है।

5. इसे एक workflow से उपयोग करें

jobs:
  build:
    runs-on: self-hosted
    steps:
      - uses: actions/checkout@v4
      - run: make build && make test

Docker जॉब (वैकल्पिक)

Docker एक बार इंस्टॉल करें, और workflow ऐसी इमेज बना सकते हैं जहाँ लेयर कैश रन के बीच बना रहे:

sudo apt install -y docker.io
sudo usermod -aG docker runner

देखें VPS पर Docker इंस्टॉल करना। साइज़िंग: Small ($8/माह) अधिकांश CI के लिए आरामदायक है; भारी कंपाइलेशन के लिए ऊपर बढ़ें। लगभग एक मिनट में root, कोई KYC नहीं, क्रिप्टो में भुगतान।

सामान्य प्रश्न

सेल्फ-होस्टेड GitHub Actions runner कैसे रजिस्टर करूँ?

अपने repo (या org) में: Settings → Actions → Runners → New self-hosted runner → Linux। GitHub एक डाउनलोड कमांड और एक बार का रजिस्ट्रेशन टोकन दिखाता है। non-root उपयोगकर्ता के रूप में runner डाउनलोड करें, उस URL और टोकन से ./config.sh चलाएँ, फिर svc.sh से इसे सेवा के रूप में इंस्टॉल करें। कदम नीचे हैं।

runner root के रूप में क्यों नहीं चल सकता?

runner डिज़ाइन के अनुसार root के रूप में चलने से इनकार करता है। एक समर्पित non-root उपयोगकर्ता बनाएँ (adduser runner) और वहीं सेट करें। यह उस सीमा को भी घटाता है कि कोई दुर्भावनापूर्ण workflow आपकी मशीन पर क्या छू सके।

रीबूट के बाद runner को चलता कैसे रखूँ?

साथ आए svc.sh हेल्पर का उपयोग करें: sudo ./svc.sh install runner && sudo ./svc.sh start। यह एक systemd यूनिट इंस्टॉल करता है ताकि runner बूट पर शुरू हो, विफलता पर फिर चालू हो, और GitHub UI में Idle दिखे।

क्या runner के लिए समर्पित IP चाहिए?

नहीं। runner HTTPS पर GitHub की ओर बाहर की ओर डायल करता है; इस तक किसी इनबाउंड कनेक्शन की ज़रूरत नहीं। एक NAT प्लान ($3/माह से) काम करता है। समर्पित IP केवल तभी लें जब आप कुछ ऐसा भी सेल्फ-होस्ट करें जो ट्रैफ़िक सर्व करता हो।

क्या आप पहचान-पत्र या कार्ड माँगते हैं?

नहीं। साइन अप के लिए एक ईमेल, USDC या USDT में भुगतान — कोई दस्तावेज़ नहीं, कोई कार्ड नहीं। लगभग एक मिनट में root।