# Instalarea EZWeb pe un server nou — 0.4.2

Ghidul ușor de urmat, cu buton de copiere și înregistrările completate cu domeniul tău, este la
https://licente.ezweb.ro/downloads/index.html. Această variantă text folosește domeniul de exemplu `exemplu.ro`.

Versiune: `0.4.2`  
SHA-256 arhivă: `530ecaa1da5eca4fb62bf93c07b9c49984f5be39636eb43343bb40bad2f60226`  
Cheie publică issuer: `issuer-ed25519-public-key.txt`  
URL descărcare: `https://licente.ezweb.ro/downloads/`

## Înainte să începi

- un server **Ubuntu Server 24.04** x86_64 proaspăt instalat, fără alte aplicații;
- **2 GB RAM** și **20 GB disc** pentru test sau câteva site-uri mici (instalarea ocupă aproximativ 12 GB, iar sub 3 GB RAM installerul adaugă singur swap); pentru producție recomandăm **4 GB RAM** și **40 GB disc** sau mai mult;
- un IPv4 public fix și acces SSH la server;
- un domeniu pentru panou, la orice registrar sau în Cloudflare;
- o licență EZWeb activă, din [contul tău de licențe](https://licente.ezweb.ro/cont);
- porturile `21`, `25`, `80`, `443`, `465`, `587`, `993`, `4190` și `50000–50019` deschise și în firewallul furnizorului, dacă are unul; plus `53` dacă vrei nameservere proprii.

Nu rula installerul peste un server care găzduiește deja site-uri. Pentru livrarea emailului, verifică la furnizor că serverul are voie să trimită pe portul `25` și setează reverse DNS (PTR) pentru IPv4; installerul nu le poate configura.

## Pasul 1 — Pregătește DNS-ul domeniului

Unde este găzduit DNS-ul lui **exemplu.ro** (la registrar, la firma de hosting sau în Cloudflare), adaugă înregistrări de tip `A` către IPv4-ul serverului. Installerul le verifică singur și îți spune dacă lipsește vreuna.

| Nume | Tip | Valoare | Pentru |
| --- | --- | --- | --- |
| `panel.exemplu.ro` | A | `IP_SERVER` | panoul de administrare |
| `mail.exemplu.ro` | A | `IP_SERVER` | serverul de email |
| `webmail.exemplu.ro` | A | `IP_SERVER` | webmailul |
| `ftp.exemplu.ro` | A | `IP_SERVER` | FTP |
| `verificare.exemplu.ro` | A | `IP_SERVER` | testul de la finalul instalării; nu e necesar în Cloudflare |
| `ns1.exemplu.ro` | A | `IP_SERVER` | doar pentru nameservere proprii |
| `ns2.exemplu.ro` | A | `IP_SERVER` | doar pentru nameservere proprii |

În Cloudflare alege **DNS only** (norul gri) pentru toate. Dacă domeniul e în Cloudflare, installerul poate crea singur înregistrările: pregătește **Zone ID** (pagina **Overview** a domeniului, secțiunea **API**) și un token creat din **My Profile** → **API Tokens** → **Create Token** → **Edit zone DNS**, pentru acest domeniu.

## Pasul 2 — Ia cheia de activare

Intră în [contul tău de licențe](https://licente.ezweb.ro/cont), la **Licențele mele**, apasă **Afișează cheia**, confirmă parola și apoi **Copiază cheia**. Cheia are 64 de caractere; installerul ți-o cere la final, într-un câmp ascuns.

## Pasul 3 — Rulează installerul

Conectează-te la server prin SSH și lipește comanda:

```sh
curl -fsSLo ezweb-install.sh 'https://licente.ezweb.ro/downloads/install.sh' && sudo bash ezweb-install.sh
```

Installerul verifică serverul, descarcă arhiva, îi verifică semnătura SHA-256 și apoi te întreabă tot ce îi trebuie. Rulează într-o sesiune `tmux`: dacă se rupe conexiunea, reconectează-te și scrie `sudo tmux attach -t ezweb`.

## Pasul 4 — Răspunde la întrebări

| Întrebare | Ce răspunzi |
| --- | --- |
| Domeniul principal | `exemplu.ro` |
| Folosesc aceste adrese? | `Enter` |
| IPv4-ul public al serverului | `Enter` dacă e cel detectat, altfel `IP_SERVER` |
| Unde sunt înregistrările DNS? | `1` pentru registrar sau hosting, `2` pentru Cloudflare |
| Nameservere proprii pentru clienți? | `Enter` (nu), sau `d` pentru ns1/ns2, ca la cPanel |
| Verific DNS-ul | toate cu ✓; altfel adaugi ce lipsește și alegi **Verifică din nou** |
| Email și administrator | `Enter`, sau valorile tale |
| Cheia de activare | lipești cheia din Pasul 2; nu apare pe ecran |
| Pornesc instalarea? | `da` |

Instalarea durează de obicei zeci de minute. La final, installerul îți arată adresa panoului și unde găsești parola inițială.

## Nameservere proprii, ca la cPanel

Dacă alegi nameservere proprii, serverul răspunde la DNS pentru domeniile clienților. Clientul își pune la registrar nameserverele **ns1.exemplu.ro** și **ns2.exemplu.ro**, iar zona lui apare și se administrează din panou. Pentru asta, `ns1` și `ns2` trebuie să indice spre server și portul `53` să fie deschis. Înregistrările domeniului tău (`panel`, `mail` și celelalte) rămân unde le-ai pus la Pasul 1.

## Dacă instalarea se întrerupe

Rulează din nou installerul. Găsește instalarea începută și o continuă de unde a rămas:

```sh
sudo bash ezweb-install.sh
```

Dacă ai închis doar fereastra SSH, instalarea a continuat; revii în ea cu `sudo tmux attach -t ezweb`.

## Mesaje frecvente

- `EZWeb se instalează pe Ubuntu Server 24.04 x86_64`: Serverul are alt sistem. Reinstalează VPS-ul din panoul furnizorului cu Ubuntu Server 24.04.
- `Rulează cu sudo`: Comanda trebuie pornită cu `sudo`, exact ca în Pasul 3.
- `✗ lipsește`: Înregistrarea nu există încă. Adaug-o la Pasul 1, așteaptă câteva minute și alege **Verifică din nou**.
- `✗ trece prin proxy-ul Cloudflare (norul portocaliu)`: În Cloudflare, la **DNS** → **Records**, pune **Proxy status** pe **DNS only**.
- `Cloudflare a refuzat tokenul`: Tokenul trebuie creat cu șablonul **Edit zone DNS** pentru domeniul tău, iar Zone ID trebuie să fie al aceluiași domeniu.
- `Application ports are already in use`: Imaginea furnizorului rulează deja un server web sau de email. Folosește o imagine Ubuntu curată, fără aplicații preinstalate.
- `Arhiva descărcată nu corespunde`: Descărcarea s-a întrerupt. Rulează din nou comanda din Pasul 3.

## După instalare

Deschide **https://panel.exemplu.ro** și autentifică-te cu utilizatorul administrator. Parola inițială și cheia pentru Authenticator sunt într-un fișier privat de pe server. Îl citești cu comanda de mai jos și ieși cu `q`:

```sh
sudo less /var/lib/ezweb-panel-web/access.json
```

Salvează parola într-un manager de parole și adaugă contul în aplicația Authenticator. Nu trimite aceste date pe email sau chat. Webmailul este la **https://webmail.exemplu.ro** și folosește adresa și parola căsuței de email, nu contul administratorului.

Primul site: în panou, **Pachete hosting** → **Pachet nou** → **Creează pachetul**, apoi **Conturi de hosting** → **Creare și import** → **Hosting nou**. Completează clientul, utilizatorul și domeniul, alege pachetul și apasă **Creează hostingul**. Pentru email, mergi la **Email, FTP și cron** → **Căsuțe** → **Căsuță nouă**; pentru backup, la **Backupuri** → **Creează backup**. Mai multe în [tutoriale](https://licente.ezweb.ro/tutoriale).

Activarea licenței se face online. Dacă serviciul de licențiere nu răspunde, panoul continuă cel mult șapte zile, în limita abonamentului. La expirare se restricționează administrarea; site-urile și emailul continuă să funcționeze. Installerul nu colectează plăți și nu cere date de card.

## Vrei să verifici arhiva separat?

Installerul verifică singur SHA-256. Dacă vrei să verifici și tu arhiva, rulează pe server:

```sh
cd ~
umask 022
curl --fail --location --output 'ezweb-installer-0.4.2.tar.gz' 'https://licente.ezweb.ro/downloads/ezweb-installer-0.4.2.tar.gz'
printf '%s  %s\n' '530ecaa1da5eca4fb62bf93c07b9c49984f5be39636eb43343bb40bad2f60226' 'ezweb-installer-0.4.2.tar.gz' | sha256sum --check -
curl --fail --location --output 'issuer-ed25519-public-key.txt' 'https://licente.ezweb.ro/downloads/issuer-ed25519-public-key.txt'
```

Trebuie să apară `ezweb-installer-0.4.2.tar.gz: OK`.
