RepairAmigo स्टेप-बाय-स्टेप install करें।

RepairAmigo आपकी दुकान के किसी कंप्यूटर पर VirtualBox (जो फ्री है) के अंदर एक वर्चुअल मशीन (VM) की तरह चलता है। यह गाइड आपको शुरुआत से पहले फ़ोन की एंट्री तक ले जाती है, असली स्क्रीन के साथ।

  1. VirtualBox download करें
  2. VirtualBox install करें
  3. RepairAmigo import करें
  4. दुकान के नेटवर्क से जोड़ें
  5. VM चालू और बंद करें
  6. IP address पता करें
  7. RepairAmigo इस्तेमाल करें
  8. दिक्कतें और सवाल-जवाब

1. VirtualBox download करें

VirtualBox वर्चुअल मशीन चलाने का एक फ्री और ओपन-सोर्स प्रोग्राम है। इसे सिर्फ़ एक बार, उसी कंप्यूटर पर install करना है जिस पर RepairAmigo चलेगा। ऐसा कंप्यूटर चुनें जो दुकान खुली रहने तक चालू रहे।

ज़रूरत: RepairAmigo की VM के लिए 8 CPU और 8 GB RAM, Intel या AMD प्रोसेसर वाले 64-bit कंप्यूटर पर। बेहतर है कि यह कंप्यूटर दुकान के नेटवर्क से केबल (LAN) से जुड़ा हो।

  1. official download पेज खोलें: virtualbox.org/wiki/Downloads (पेज अंग्रेज़ी में है)।
  2. VirtualBox Platform Packages में अपने कंप्यूटर वाला पैकेज चुनें:
आपका कंप्यूटर यहाँ क्लिक करें आपको मिलेगा
Windows 10 / 11 Windows hosts एक .exe installer
Intel प्रोसेसर वाला Mac macOS / Intel hosts एक .dmg डिस्क इमेज
Linux (Ubuntu, Debian, Fedora…) Linux distributions, फिर अपना distribution और वर्ज़न एक .deb या .rpm पैकेज
  1. उसी पेज का Extension Pack ऑप्शनल है। RepairAmigo को इसकी ज़रूरत नहीं, और इसका लाइसेंस अलग है; तभी download करें जब पता हो कि चाहिए।

Apple Silicon (M1, M2, M3, M4) वाला Mac? नहीं चलेगा। RepairAmigo की VM Intel/AMD (x86-64) प्रोसेसर के लिए बनी है और Apple Silicon Mac पर नहीं चलती, "macOS / Apple Silicon hosts" पैकेज से भी नहीं। Windows या Linux वाला PC, या Intel वाला Mac इस्तेमाल करें।

कैप्शन: VirtualBox का download पेज। "VirtualBox Platform Packages" में अपना पैकेज चुनें।

2. VirtualBox install करें

VirtualBox आपके सिस्टम के हिसाब से अंग्रेज़ी में दिख सकता है। नीचे बटनों के नाम अंग्रेज़ी में हैं, जैसे स्क्रीनशॉट में।

Windows

  1. download हुई फ़ाइल (कुछ ऐसी: VirtualBox-7.x.x-…-Win.exe) पर डबल-क्लिक करें। Windows पूछे "Do you want to allow this app to make changes to your device?" (या हिंदी Windows में इसका हिंदी रूप), तो Yes दबाएँ।
  2. स्वागत स्क्रीन पर Next दबाएँ।
  3. Custom Setup में जो फ़ीचर पहले से चुने हैं उन्हें वैसे ही रहने दें और Next दबाएँ।
  4. Network Interfaces की alert बताती है कि नेटवर्क एक पल के लिए कटेगा। अपना काम सेव करें और Yes दबाएँ।
  5. अगर Missing Dependencies (Python Core / win32api) दिखे, तो आगे बढ़ने के लिए Yes दबाएँ। RepairAmigo को इसकी ज़रूरत नहीं।
  6. Install दबाएँ। जब Windows Oracle का डिवाइस software install करने को पूछे, हर बार Install दबाएँ।
  7. Finish दबाएँ। VirtualBox Manager खुल जाएगा।

अगर installer कहे कि Microsoft Visual C++ Redistributable नहीं है, तो Microsoft की साइट से उसका नया x64 वर्ज़न install करें और VirtualBox installer फिर से चलाएँ।

macOS (सिर्फ़ Intel)

.dmg खोलें, VirtualBox.pkg पर डबल-क्लिक करें और installer के steps फ़ॉलो करें। अगर macOS install रोक दे, तो System Settings → Privacy & Security खोलें, Oracle वाले मैसेज के पास Allow दबाएँ और installer फिर चलाएँ।

Linux

download हुआ पैकेज install करें। जैसे Ubuntu/Debian पर:

sudo apt install ./virtualbox-7.*.deb sudo usermod -aG vboxusers $USER

दूसरी कमांड के बाद लॉग-आउट करके फिर लॉग-इन करें। अगर कंप्यूटर में Secure Boot है, तो installer VirtualBox के kernel modules साइन करने को कह सकता है।

BIOS में virtualization चालू करें (VT-x / AMD-V)

ज़्यादातर कंप्यूटरों में यह पहले से चालू होता है। अगर बाद में VirtualBox "VT-x is disabled in the BIOS" या "AMD-V is disabled" दिखाए:

  1. कंप्यूटर रीस्टार्ट करें और BIOS/UEFI सेटअप में जाएँ (आमतौर पर चालू होते ही Del, F2, F10 या Esc दबाकर)।
  2. Intel Virtualization Technology (VT-x) या SVM Mode (AMD-V) ढूँढें, अक्सर Advanced, CPU Configuration या Security में, और उसे Enabled करें।
  3. सेव करके बाहर निकलें (अक्सर F10)।

कैप्शन: install के बाद VirtualBox Manager। आपका वर्ज़न नया हो सकता है।

3. RepairAmigo वर्चुअल मशीन import करें

RepairAmigo एक ही फ़ाइल में आता है, RepairAmigo.ova, जिसे आप VirtualBox में import करते हैं।

  1. VirtualBox खोलें और File → Import Appliance… दबाएँ, या Ctrl+I दबाएँ।
  2. Source को Local File System पर रहने दें। File के पास फ़ोल्डर आइकन दबाएँ, RepairAmigo.ova चुनें (आमतौर पर Downloads फ़ोल्डर में) और Next दबाएँ।
  3. Appliance settings जाँचें: - RAM: 8192 MB (8 GB)। बदलने के लिए वैल्यू पर डबल-क्लिक करें। - CPU: 8। बदलने के लिए वैल्यू पर डबल-क्लिक करें। - MAC Address Policy: Generate new MAC addresses for all network adapters। - Import hard drives as VDI चुना रहने दें।
  4. Finish दबाएँ (पुराने वर्ज़न में Import) और progress bar पूरी होने तक रुकें। कुछ मिनट लग सकते हैं।
  5. अब RepairAmigo बाईं तरफ़ की लिस्ट में दिखेगा।

बाद में memory या प्रोसेसर बदलने हों, तो VM बंद करें, उसे चुनें, Settings → System में Base Memory (और Processor टैब) बदलें।

कैप्शन: Settings: Base Memory 8192 MB (8 GB)। Processor टैब में 8 CPU रखें।

4. दुकान के नेटवर्क से जोड़ें (bridge मोड)

क्यों: शुरुआत में VirtualBox VM को आपके कंप्यूटर के पीछे छुपा देता है (NAT), और दुकान के दूसरे कंप्यूटर, टैबलेट और mobile उस तक नहीं पहुँच पाते। Bridged Adapter से VM दुकान के नेटवर्क पर किसी आम कंप्यूटर की तरह जुड़ती है और router से अपना IP address लेती है। इससे दुकान का हर डिवाइस RepairAmigo खोल सकता है।

  1. VM बंद है, यह पक्का करें। RepairAmigo चुनें और Settings दबाएँ।
  2. Network दबाएँ। Adapter 1 में Enable Network Adapter चुनें।
  3. Attached to में Bridged Adapter चुनें।
  4. Name में वह नेटवर्क कार्ड चुनें जिससे यह कंप्यूटर दुकान के नेटवर्क से जुड़ा है: Ethernet (recommended) या Wi-Fi। Windows में नाम कुछ ऐसा होता है: "Intel(R) Ethernet…" या "Realtek PCIe GbE…"।
  5. OK दबाएँ।

कैप्शन: Network → Adapter 1 → Bridged Adapter। आपके कंप्यूटर पर कार्ड का नाम अलग होगा।

टिप: हो सके तो LAN केबल लगाएँ। कुछ Wi-Fi नेटवर्क (गेस्ट नेटवर्क, कुछ mesh सिस्टम) bridge मोड वाली VM को नहीं चलने देते।

5. VM चालू और बंद करें

  1. RepairAmigo चुनें और Start के पास वाले तीर को दबाएँ: - Normal Start VM की स्क्रीन वाली विंडो खोलता है। पहली बार इसी से चलाएँ, ताकि IP address दिखे। - Headless Start VM को बिना विंडो के बैकग्राउंड में चलाता है। रोज़ के लिए यही ठीक है।
  2. 1 से 2 मिनट रुकें, जब तक VM की स्क्रीन पर RepairAmigo का हेडर खोलने वाले address के साथ न दिखे, जैसे http://192.168.1.50/, और उसके नीचे लॉगिन प्रॉम्प्ट। वहाँ लॉगिन करने की ज़रूरत नहीं: यही address दुकान के किसी भी कंप्यूटर के browser में खोलें (स्टेप 7)।
  3. बंद करने के लिए VM पर राइट-क्लिक करें और Stop → ACPI Shutdown चुनें (VM विंडो में: Machine → ACPI Shutdown)। इससे डेटाबेस ठीक से बंद होता है।

"Power Off" से बचें। यह प्लग खींचने जैसा है और डेटाबेस खराब कर सकता है। अगर VM विंडो बंद करें, तो Send the shutdown signal चुनें, Power off the machine नहीं। कंप्यूटर रीस्टार्ट या बंद करने से पहले हमेशा VM बंद करें।

RepairAmigo अपने आप चालू हो

"C:\Program Files\Oracle\VirtualBox\VBoxManage.exe" startvm "RepairAmigo" --type headless

6. VM का IP address पता करें

  1. VM की स्क्रीन देखें। VM चालू होने पर स्क्रीन पर RepairAmigo के हेडर में IP address दिखता है, जैसे Repair Amigo - अपने browser में http://192.168.1.50/ खोलें। उसी नेटवर्क के किसी भी कंप्यूटर, टैबलेट या mobile के browser में http://<IP-address>/ टाइप करें। अगर Headless Start किया था, तो VM पर राइट-क्लिक करके Show चुनें।
  2. या router में देखें। router का एडमिन पेज खोलें और DHCP clients (या connected devices) की लिस्ट देखें। repairamigo नाम का डिवाइस या 08:00:27 (VirtualBox) से शुरू होने वाला MAC address ढूँढें।

सुझाव: address रिज़र्व कर दें। router में VM के MAC address के लिए DHCP reservation (जिसे fixed IP भी कहते हैं) बनाएँ। तब IP कभी नहीं बदलेगा और दुकान के डिवाइसों के bookmark चलते रहेंगे। VM का MAC देखने के लिए: Settings → Network, ऊपर बाईं तरफ़ Expert पर जाएँ और Advanced → MAC Address खोलें।

7. RepairAmigo इस्तेमाल करें

RepairAmigo दुकान के उसी नेटवर्क से जुड़े किसी भी कंप्यूटर, टैबलेट या mobile के browser से चलता है। सब कुछ, आपका डेटा भी, software के अंदर से ही संभलता है।

पहली बार: शुरुआती सेटअप और मालिक अकाउंट

  1. दुकान के किसी भी डिवाइस पर http://<IP-address>/ खोलें, जैसे http://192.168.1.50/। पहली बार शुरुआती सेटअप स्क्रीन खुलती है।
  2. दुकान का नाम और टाइम ज़ोन डालें और पासवर्ड के साथ मालिक अकाउंट बनाएँ।
  3. मालिक का पासवर्ड संभालकर रखें। इस अकाउंट के पास सबसे ज़्यादा access हैं: यूज़र, सेटिंग्स और आपका डेटा।

कैप्शन: शुरुआती सेटअप: दुकान की जानकारी और मालिक अकाउंट (डेमो डेटा)।

रोज़ाना: लॉगिन

  1. http://<IP-address>/ खोलें और अपने यूज़र से लॉगिन करें।
  2. दुकान के हर डिवाइस पर इसे bookmark कर लें (या mobile और टैबलेट पर "Add to Home screen" करें)।
  3. मालिक एडमिन मेन्यू से मैनेजर और टेक्नीशियन जोड़ सकता है।

कैप्शन: RepairAmigo का मुख्य मेन्यू (डेमो डेटा)।

आपका डेटा: export और import

यह सिर्फ़ मालिक कर सकता है। जाएँ: मुख्य मेन्यू → एडमिन → सिर्फ़ मालिक।

डेटा export करें से आप download कर सकते हैं:

सुरक्षा के लिए SQL और CSV export में यूज़र पासवर्ड के hash और SMS (Twilio) की credentials शामिल नहीं होतीं।

passphrase संभालकर रखें। इसके बिना माइग्रेशन पैकेज नहीं खुलता, और कोई भी, RepairAmigo भी, इसे वापस नहीं ला सकता।

डेटा import करें एक माइग्रेशन पैकेज (.ramig) लोड करता है और इस RepairAmigo का सारा डेटा बदल देता है:

  1. .ramig फ़ाइल चुनें और passphrase व अपना मालिक पासवर्ड डालें।
  2. सिर्फ़ जाँचें चुना रहने दें और पहले Import दबाएँ। इससे पैकेज बिना कुछ बदले जाँच लिया जाता है।
  3. सच में डेटा बदलना हो, तो सिर्फ़ जाँचें हटाएँ, IMPORT टाइप करें और Import दबाएँ। उससे पहले software मौजूदा डेटा का सुरक्षा backup लेता है, और ज़रूरत पड़े तो पिछला वापस लाएँ सब वापस कर देता है।

आपको किसी डेटाबेस टूल की ज़रूरत नहीं। RepairAmigo में phpMyAdmin या डेटाबेस का सीधा एक्सेस नहीं है। सब कुछ software के अंदर से होता है, और आपका डेटा हमेशा export किया जा सकता है।

मदद चाहिए?

RepairAmigo के अंदर सपोर्ट माँगें इस्तेमाल करें (एडमिन → सेटिंग्स → सपोर्ट)। मालिक या मैनेजर मैसेज लिखता है, और RepairAmigo के जवाब उसी पेज पर दिखते हैं। आप support@repairamigo.com पर ईमेल भी कर सकते हैं। कस्टमर्स का डेटा या पासवर्ड कभी न भेजें।

8. दिक्कतें और सवाल-जवाब

VM चालू नहीं हो रही

"VT-x is disabled" / "AMD-V is disabled": BIOS में virtualization चालू करें (स्टेप 2)। "Physical network interface not found": Settings → Network खोलें और Name में अपना नेटवर्क कार्ड फिर से चुनें (स्टेप 4)। Memory कम है: दूसरे प्रोग्राम बंद करें ताकि VM के लिए 8 GB RAM खाली रहे। RepairAmigo को 8 GB (8192 MB) चाहिए; इसे कम न करें। Mac: पक्का करें कि Mac Intel वाला है। Apple Silicon नहीं चलेगा। Linux पर "kernel driver not installed": VirtualBox फिर से install करें; Secure Boot हो तो kernel modules साइन करें या allow करें।

दूसरे कंप्यूटर पर RepairAmigo नहीं खुल रहा

देखें कि Adapter 1 Bridged Adapter पर है, NAT पर नहीं (स्टेप 4)। दोनों डिवाइस दुकान के एक ही नेटवर्क पर हों, गेस्ट Wi-Fi पर नहीं। पूरा address http:// के साथ टाइप करें, जैसे http://192.168.1.50/। हो सकता है IP बदल गया हो: VM की स्क्रीन फिर देखें और DHCP reservation बनाएँ (स्टेप 6)। Wi-Fi पर हैं तो केबल से आज़माएँ। जिस डिवाइस से खोल रहे हैं उस पर VPN बंद करें।

मालिक का पासवर्ड भूल गया

सुरक्षा के लिए मालिक का पासवर्ड इस वेबसाइट से रीसेट नहीं होता। किसी मैनेजर से लॉगिन करवाएँ और सपोर्ट माँगें (एडमिन → सेटिंग्स → सपोर्ट) से मैसेज भेजें; RepairAmigo का जवाब उसी पेज पर आएगा। कोई कर्मचारी अपना पासवर्ड भूल जाए तो वह मालिक या मैनेजर से मदद ले।

RepairAmigo धीमा चल रहा है

देखें कि VM को 8 CPU और 8192 MB (8 GB) memory मिली है (VM बंद → Settings → System)। कंप्यूटर में memory खाली रखें और भारी प्रोग्राम बंद करें। VM को SSD पर रखें, पुरानी hard disk (HDD) पर नहीं। Windows में VM विंडो पर हरा कछुआ दिखे तो Hyper-V VirtualBox को धीमा कर रहा है; "Turn Windows features on or off" में Hyper-V और Virtual Machine Platform बंद करने से आमतौर पर ठीक हो जाता है। कंप्यूटर को नेटवर्क से केबल से जोड़ें।

क्या VirtualBox खुला रखना ज़रूरी है?

नहीं। Headless Start से VM बैकग्राउंड में चलती रहती है, VirtualBox Manager बंद करने पर भी। बस कंप्यूटर चालू रहे और sleep में न जाए।

backup कैसे लूँ?

अपना डेटा बार-बार export करें (स्टेप 7) और उसकी कॉपी किसी और जगह रखें, जैसे पेन ड्राइव या दूसरा कंप्यूटर। कोई VM डिलीट करने से पहले हमेशा export करें: VM डिलीट करने से उसके अंदर का डेटा भी चला जाता है।

क्या RepairAmigo सच में फ्री है?

हाँ। RepairAmigo download करना और इस्तेमाल करना फ्री है: न महीने का किराया, न credit card, न हर job card का कोई पैसा।

फ्री लाइसेंस: इसके बदले में, RepairAmigo चलते समय आपके कंप्यूटर की प्रोसेसिंग क्षमता के एक हिस्से का उपयोग करता है। पूरी शर्तें EULA में दी गई हैं।

job card या यूज़र की कोई लिमिट है?

नहीं। job card और यूज़र की कोई लिमिट नहीं। हर दुकान का एक installation।

क्या RepairAmigo क्लाउड पर चलता है?

नहीं। यह आपकी दुकान के एक कंप्यूटर पर चलता है और टीम दुकान के नेटवर्क के अंदर browser से खोलती है। रिपेयर, कस्टमर और स्टॉक का रिकॉर्ड आपके अपने कंप्यूटर में रहता है, और मालिक जब चाहे export कर सकता है।

क्या mobile app है?

Play Store या App Store पर कोई app नहीं है। दुकान के नेटवर्क से जुड़ा कोई भी mobile या टैबलेट browser में RepairAmigo खोल सकता है, उन्हीं नियमों और रेट के साथ, और आप इसे होम स्क्रीन पर जोड़ सकते हैं।

क्या software हिंदी में है?

यह पेज हिंदी में है। software की हिंदी edition अभी तैयार हो रही है; download से पहले download पेज पर देखें कि कौन सी भाषा वाली edition available है।

कस्टमर को SMS कैसे जाता है?

कस्टमर को SMS भेजना ऑप्शनल है। SMS सिर्फ़ एक तरफ़ (one-way) जाता है, यानी कस्टमर software में जवाब नहीं दे सकता, और दुकान के अपने Twilio अकाउंट से जाता है। मैसेज का खर्च दुकान सीधे Twilio को देती है, और भेजने के लिए internet चाहिए। SMS शुरुआत में बंद रहता है। भारत के नंबरों पर SMS भेजने के लिए Twilio में DLT रजिस्ट्रेशन करवाना पड़ सकता है।

क्या कार्ड या UPI से पेमेंट लेता है?

RepairAmigo पेमेंट प्रोसेस नहीं करता। कैश बिक्री (POS) स्क्रीन और कैश का हिसाब दुकान में आने-जाने वाले पैसे को दर्ज करते हैं।

क्या RepairAmigo WhatsApp से मैसेज भेजता है?

नहीं। RepairAmigo में WhatsApp integration नहीं है। कस्टमर को मैसेज सिर्फ़ SMS से जाते हैं: ऑप्शनल, सिर्फ़ एक तरफ़ (one-way), दुकान के अपने Twilio अकाउंट से। भारत के नंबरों पर SMS भेजने के लिए Twilio में DLT रजिस्ट्रेशन करवाना पड़ सकता है।

क्या RepairAmigo GST invoice बनाता है?

नहीं। RepairAmigo GST invoice नहीं बनाता और GST billing का software नहीं है। इसकी रसीद repair job card की रसीद है। GST bill के लिए जो software या तरीका आप अभी इस्तेमाल करते हैं, वही चलाते रहें।

अब भी सवाल हैं?

गाइड पढ़ें या support@repairamigo.com पर लिखें।