# CloudPanel

&lt;! CloudPanel CE als addon op de eigen klantVPS. Draait NIET centraal bij ons.

# CloudPanel

<!-- CloudPanel CE als add-on op de eigen klant-VPS. Draait NIET centraal bij ons. -->

# CloudPanel CE — handleiding

```
$ https://<jouw-vps-ip>:8443
```

CloudPanel CE is een gratis, open-source serverbeheerpaneel (sites, PHP, databases, SSL, cron, vhosts) dat wij als **add-on** voor je installeren op **je eigen InternalHost VPS**. Er is **geen centrale CloudPanel-host bij ons** — het paneel draait volledig op jouw machine en is alleen van jou. Je bereikt het op `https://<jouw-vps-ip>:8443`.

Onder de motorkap SSH't onze installer naar het IP van je gekoppelde VPS en draait de officiële CloudPanel-installer. Daarna is het paneel jouw domein.

> CloudPanel maakt je VPS niet "managed". Het is een UI bovenop je eigen unmanaged server. Wil je dat iemand het beheert? → [EASEO](https://easeo.nl).

---

## Wat is het (en wat niet)

- **Wel:** een webinterface om vhosts, PHP-versies, MySQL/MariaDB-databases, Let's Encrypt-certificaten, cronjobs, SSH/FTP-users en basis-firewall te beheren op één server.
- **Niet:** een hostingaccount bij ons, een gedeeld paneel, of iets dat los van je VPS bestaat. Verwijder je de VPS, dan is CloudPanel weg.
- **Eis:** een draaiende InternalHost VPS (Ubuntu of Debian wordt door CloudPanel ondersteund). CloudPanel CE draait op MySQL 8.x of MariaDB.

---

## Aan de slag

### 1. Bestel de CloudPanel-add-on

In je [klantenpaneel](https://internalhost.eu) koppel je de CloudPanel-add-on aan een bestaande VPS-dienst. Wij draaien dan de officiële installer op die VPS via SSH (we gebruiken het opgeslagen IP + root-wachtwoord van je VPS-dienst).

### 2. Open het paneel

```
https://<jouw-vps-ip>:8443
```

Je browser waarschuwt voor het self-signed certificaat — dat klopt, je hebt nog geen domein gekoppeld. Klik door (of zie *SSL* hieronder om het paneel achter een domein met geldig certificaat te zetten).

### 3. Maak de admin-user

Bij eerste bezoek vraagt CloudPanel om een admin-account aan te maken (naam, e-mail, wachtwoord). **Dit wachtwoord beheren wij niet** — bewaar het zelf.

### 4. Firewall: poort 8443 open

CloudPanel luistert op TCP **8443**. Heb je ufw/nftables aanstaan op je VPS:

```bash
sudo ufw allow 8443/tcp
```

> Overweeg 8443 te beperken tot je eigen IP: `sudo ufw allow from <jouw-thuis-ip> to any port 8443 proto tcp`.

---

## Veelvoorkomende taken

### Eerste site toevoegen

1. In CloudPanel: **Sites → Add Site**.
2. Kies het type (PHP-site, Static, Node.js, Python, Reverse Proxy).
3. Vul je domein in (bv. `jouwdomein.nl`) en kies de PHP-versie.
4. CloudPanel maakt de vhost, de document-root en een site-user aan.

Wijs vooraf je domein naar de VPS bij je registrar:

```
A     @      <jouw-vps-ip>
A     www    <jouw-vps-ip>
```

Officiële stappen: [CloudPanel Docs — Add Site](https://www.cloudpanel.io/docs/v2/frontend-area/add-site/).

### SSL / HTTPS (Let's Encrypt)

Open de site in CloudPanel → tab **SSL/TLS → Actions → New Let's Encrypt Certificate**. CloudPanel vraagt en vernieuwt het certificaat automatisch zolang het domein naar de VPS wijst (DNS moet kloppen, poort 80 open).

### Database aanmaken

1. **Databases → Add Database**.
2. Geef een naam, een database-user en een sterk wachtwoord.
3. Ken de user de juiste rechten toe.

Beheer via de ingebouwde phpMyAdmin/Adminer-link of verbind van buitenaf (open dan poort 3306 alleen voor jouw IP). Officiële referentie: [CloudPanel Docs — Databases](https://www.cloudpanel.io/docs/v2/frontend-area/databases/).

### PHP-versie wisselen

Per site instelbaar onder de site → **Settings → PHP**. CloudPanel CE biedt meerdere PHP-versies naast elkaar; je kiest per vhost.

### Updates van CloudPanel

CloudPanel updatet zichzelf via het systeempakket op je VPS:

```bash
sudo clpctl update
```

(`clpctl` is de CLI van CloudPanel — ook handig voor user-resets en backups.)

### Admin-wachtwoord vergeten

Vanaf de VPS via de CLI:

```bash
sudo clpctl user:reset:password --userName=admin
```

---

## Problemen oplossen

| Symptoom | Oplossing |
|---|---|
| `https://<ip>:8443` laadt niet | Poort 8443 dicht in firewall: `sudo ufw allow 8443/tcp`. Of CloudPanel-service down: `sudo systemctl status nginx`. |
| Certificaat-waarschuwing op :8443 | Verwacht (self-signed). Koppel een domein + Let's Encrypt voor het paneel, of klik door. |
| Let's Encrypt faalt | DNS wijst nog niet naar de VPS, of poort 80 dicht. `dig +short jouwdomein.nl`, `sudo ufw allow 80/tcp`. |
| Site geeft 502/504 | PHP-FPM van die site herstarten via de site-settings, of `sudo systemctl restart php*-fpm`. |
| Installer mislukte | OS niet ondersteund (gebruik Ubuntu/Debian) of te weinig RAM (min. 2 GB aangeraden). Open een ticket. |

---

## FAQ

**Waar draait CloudPanel — bij InternalHost of op mijn server?**
Op **jouw** VPS. Er is geen centrale CloudPanel bij ons. Het paneel is van jou, op `https://<jouw-vps-ip>:8443`.

**Kost CloudPanel CE licentiegeld?**
CloudPanel Community Edition is gratis en open-source. Wij rekenen alleen de installatie/add-on; de software zelf heeft geen licentiekosten (geen cPanel-belasting).

**Op welk OS werkt het?**
Ubuntu en Debian (de door CloudPanel ondersteunde versies). Bestel je VPS dus met Ubuntu 22.04/24.04 of Debian 12/13.

**Maakt CloudPanel mijn VPS managed?**
Nee. Het is een beheer-UI; de verantwoordelijkheid voor de server blijft bij jou. Voor echt managed: [EASEO](https://easeo.nl).

**Kan ik het paneel later verwijderen?**
Ja, maar de schoonste route is je sites/databases backuppen en de VPS herinstallen. CloudPanel grijpt diep in nginx/PHP/MySQL in; "even deïnstalleren" is rommelig.

**Kan ik meerdere sites op één VPS draaien?**
Ja, dat is precies waar CloudPanel voor is — meerdere vhosts, elk met eigen PHP-versie, database en SSL.

**Beheren jullie het admin-wachtwoord?**
Nee. Je maakt het zelf bij eerste login; reset kan via `sudo clpctl user:reset:password` op de VPS.

**Krijg ik backups van mijn sites?**
CloudPanel heeft ingebouwde backup-functies (o.a. naar S3-compatible storage via `clpctl`). Configureer dit zelf — bv. naar onze [S3 Storage](https://internalhost.eu/products/s3-storage). Wij backuppen je VPS niet automatisch.

---

## Bronnen

- [CloudPanel Documentatie (v2)](https://www.cloudpanel.io/docs/v2/)
- [CloudPanel Docs — Add Site](https://www.cloudpanel.io/docs/v2/frontend-area/add-site/)
- [CloudPanel Docs — Databases](https://www.cloudpanel.io/docs/v2/frontend-area/databases/)
- [CloudPanel Docs — Installatie (other / generic)](https://www.cloudpanel.io/docs/v2/getting-started/other/)
- [InternalHost CloudPanel-extensie (broncode)](https://github.com/internalhost-eu/cloudpanel-internalhost)