Documentationالتوثيق

Requirementsالمتطلبات

• Debian 13 (trixie) 64-bit
• 2 CPU coresمعالج بنواتين
• 4 GB RAMذاكرة 4 GB
• 20 GB diskهارد 20 GB

Ports: 80 and 443 (panel), UDP 1812 and 1813 (RADIUS authentication and accounting) from your devices' network. A physical server, a virtual machine or a VPS all work.

المنافذ: 80 و443 للوحة، وUDP 1812 و1813 (مصادقة ومحاسبة RADIUS) من شبكة أجهزتك. يشتغل على سيرفر حقيقي أو جهاز وهمي أو VPS.

Install from the ISO (no internet needed)التنصيب من ISO (بدون إنترنت)

1. Download the ISO from the download link.
2. Write it to a USB stick with Rufus (choose DD image mode) or balenaEtcher. Do not copy the file onto the stick.
3. Boot the server from the stick. The installation erases the whole disk.
4. Choose the language, country and keyboard. Everything else installs by itself in 5 to 10 minutes, then the server restarts.
5. Sign in as root with the temporary password and choose a new one.
6. The Wiven console opens: set the IP address, gateway and DNS, then run the setup (see First sign-in).

1. حمّل ملف ISO من رابط التحميل.
2. احرقه على فلاش ببرنامج Rufus (اختر وضع DD image) أو balenaEtcher. لا تنسخ الملف للفلاش نسخاً عادياً.
3. شغّل السيرفر من الفلاش. التنصيب يمسح الهارد بالكامل.
4. اختر اللغة والبلد والكيبورد. الباقي ينصّب وحده خلال 5 إلى 10 دقائق، ثم يعيد السيرفر التشغيل.
5. سجّل دخول بحساب root بكلمة المرور المؤقتة واختر كلمة جديدة.
6. تفتح شاشة Wiven: اضبط الـ IP والـ Gateway والـ DNS، ثم شغّل الإعداد (انظر أول دخول).

Install on an existing Debian 13 serverالتنصيب على سيرفر Debian 13 موجود

For a server or VPS that already runs Debian 13 with internet access. Run as root:

لسيرفر أو VPS عليه Debian 13 ومتصل بالإنترنت. نفّذ بحساب root:

curl -fsSL https://wiven-systems.com/install.sh -o install.sh
sudo bash install.sh

The script installs the system packages from Debian, downloads Wiven and checks it against its published SHA-256, then runs the same setup as the ISO. It does not change the server's network settings.

السكربت ينصّب حزم النظام من مستودعات Debian، وينزّل Wiven ويتحقق منه ببصمة SHA-256 المنشورة، ثم يشغّل نفس إعداد الـ ISO. ما يغيّر إعدادات الشبكة مال السيرفر.

First sign-inأول دخول

The setup asks four questions:

الإعداد يسأل أربعة أسئلة:

1. Company name.
2. Administrator username (default admin).
3. Administrator password: 12 characters or more, or press Enter to generate one (it is shown once, keep it).
4. The network your devices send RADIUS from, for example 10.0.0.0/8; only this network can reach the RADIUS ports.

1. اسم الشركة.
2. اسم مستخدم المدير (الافتراضي admin).
3. كلمة مرور المدير: 12 حرفاً أو أكثر، أو اضغط Enter لتوليدها (تظهر مرة واحدة، احفظها).
4. الشبكة التي ترسل منها أجهزتك طلبات RADIUS، مثلاً 10.0.0.0/8؛ فقط هذه الشبكة تصل لمنافذ RADIUS.

Then open http://<server-ip>/ and sign in. Every new installation starts with a free 30-day trial license.

ثم افتح http://<server-ip>/ وسجّل دخول. كل تنصيب جديد يبدأ بترخيص تجريبي مجاني لمدة 30 يوماً.

Connect your network devicesربط أجهزة الشبكة

In the panel open NAS and add the device: its name, IP address and a shared secret. Wiven works with MikroTik, Cisco and any device that speaks standard RADIUS. Then point the device at Wiven. On MikroTik RouterOS:

من اللوحة افتح NAS وأضف الجهاز: اسمه وعنوانه IP وكلمة سر مشتركة (secret). Wiven يشتغل مع MikroTik وCisco وأي جهاز يدعم RADIUS القياسي. بعدها وجّه الجهاز لـ Wiven. على MikroTik RouterOS:

/radius add address=<wiven-ip> secret="<shared-secret>" service=ppp,hotspot timeout=3s comment="Wiven RADIUS"
/radius incoming set accept=yes port=1700
/ppp aaa set use-radius=yes accounting=yes interim-update=1m

port=1700 must match the CoA port of the NAS in the panel (1700 by default); Wiven uses it to disconnect a user or apply a new speed straight away.

port=1700 لازم يطابق منفذ CoA للـ NAS في اللوحة (الافتراضي 1700)؛ يستخدمه Wiven لفصل المشترك أو تطبيق سرعة جديدة فوراً.

HTTPS & securityHTTPS والأمان

Open Settings → Security in the company account:

افتح الإعدادات ← الأمان من حساب الشركة:

• HTTPS for the panel: one switch. The server makes its own certificate for its IP address and the panel moves to https://. Browsers show a warning the first time because the certificate is the server's own; choose to continue.
• Verification code at sign-in: a code image on the login page that must be typed with the password; it stops password-guessing programs.

• HTTPS للوحة: مفتاح واحد. السيرفر يولّد شهادة خاصة بعنوانه وتتحول اللوحة إلى https://. المتصفح يعرض تنبيهاً بأول مرة لأن الشهادة خاصة بالسيرفر؛ اختر المتابعة.
• رمز التحقق عند الدخول: صورة رمز في صفحة الدخول يجب كتابته مع كلمة المرور؛ تمنع برامج تخمين كلمات المرور.

Updates & backupsالتحديثات والنسخ الاحتياطي

Updates install from the panel (System tools → Updates). Every update is signed by Wiven; before it is applied the database is backed up, and if anything fails the previous version is restored automatically. Backups can also be downloaded from Backup & Restore.

التحديثات تنصّب من اللوحة (أدوات النظام ← التحديثات). كل تحديث موقّع من Wiven؛ قبل تطبيقه تؤخذ نسخة احتياطية من قاعدة البيانات، وإذا فشل أي شيء ترجع النسخة السابقة تلقائياً. ويمكن تحميل النسخ الاحتياطية من النسخ الاحتياطي والاستعادة.

Supportالدعم

Open a ticket from Support in your panel, or write to support@wiven-systems.com. For licenses: sales@wiven-systems.com.

افتح تذكرة من الدعم في لوحتك، أو راسلنا على support@wiven-systems.com. للتراخيص: sales@wiven-systems.com.