Projekti i web
Domena, PHP 7.4–8.4, Apache ili Nginx backend, PHP-FPM pool po projektu, virtual host editor, CMS PHP preseti, open_basedir, file manager i SSL certifikati.
Open-source · Ubuntu poslužitelji · Ubuntu 24.04
uAdmin
Open-source platforma za upravljanje Ubuntu poslužiteljima, web aplikacijama i razvojnim okruženjima.
uAdmin (Ubuntu Web Admin) je open-source web panel za Ubuntu poslužitelje, namijenjen programerima i sistem administratorima kojima je potrebno više kontrole nego što nude klasični hosting paneli. Omogućuje jednostavno upravljanje serverom i web aplikacijama uz puni pristup konfiguraciji, bez skupih licenci i nepotrebnih ograničenja.
Virtual host editor, PHP-FPM poolovi po projektu, reverse proxy (Nginx frontend + Apache/Nginx backend), MariaDB, FTP, Let's Encrypt SSL, firewall, backup i OTA nadogradnje panela — sve iz jednog sučelja, uz CLI i recovery alate kad treba dirati server iz SSH-a.
Panel je napisan u Laravelu. Promjene na serveru idu isključivo kroz whitelist skripte u /usr/local/uadmin/bin — sigurno za produkciju, transparentno za sistemaše.
Verzija panela (stable) 1.0.103 (2026-06-26)
Što uAdmin nudi
Za developere i sistemaše koji žele fleksibilan LAMP hosting na vlastitom VPS-u.
Reverse proxy
Frontend Nginx na portovima 80/443, backend projekti na localhost portovima. Apache i Nginx projekti istovremeno — centralizirani SSL i HTTP/2.
Instalacije (LAMP)
GUI instalacija stacka: Apache, Nginx, PHP-FPM verzije, MariaDB, Certbot, Adminer, vsftpd, UFW. Globalni PHP.ini i PHP ekstenzije po verziji.
Backup i nadzor
Backup datoteka, baze i konfiguracije po projektu, SFTP arhiviranje, restore, logovi, audit zapisnik i nadzorna ploča s metrikama servera.
Panel i održavanje
OTA nadogradnje panela, apt održavanje OS-a, više admin korisnika, teme sučelja, SMTP, hostname/SSL panela i kontekstualna pomoć.
Recovery
Web GUI i SSH alati za rollback OTA-a, maintenance mode, popravak stacka i reset lozinke — čak i kad panel vraća 503.
Arhitektura
Odvojeni frontend proxy i backend enginei po projektu.
Internet ↓ Frontend Nginx (:80 / :443) ← SSL, HTTP→HTTPS, proxy_pass ↓ Backend Apache/Nginx (127.0.0.1:PORT) ← po projektu ↓ PHP-FPM pool · MariaDB Panel (Laravel): Nginx + PHP-FPM na :10001 (odvojen od web projekata)
- Panel (Laravel) — Nginx + PHP-FPM na portu 10001 (HTTPS preko Postavke → SSL panela)
- Web projekti — Apache ili Nginx backend na dodijeljenom internom portu (npr. 10003)
- Release model — /home/uadmin/releases/, symlink current, OTA bez gubitka podataka projekata
- Skripte — /usr/local/uadmin/bin/*.sh whitelist + sudoers; recovery izvan releasea u shared storage
Dokumentacija
Instalacija, pristup panelu, OTA, korisnici, recovery, CLI naredbe i rješavanje problema.
Nova VM (Ubuntu 24.04)
Jednolinijska instalacija na svježoj Ubuntu 24.04 virtualki (root SSH):
curl -fsSL https://enc-it.hr/uadmin/install-uadmin-from-release.sh | sudo bash
Preduvjeti
- Ubuntu 24.04 LTS (server), root pristup, otvoren port 10001 (panel) i 22 (SSH)
- Za web projekte: portovi 80 i 443 (frontend Nginx reverse proxy)
- Minimalno 1 GB RAM i 20 GB disk (preporučeno 2 GB RAM za više projekata)
Neinteraktivna instalacija (opcionalno)
Možete zadati lozinke i hostname prije pokretanja:
export UADMIN_PANEL_HOSTNAME="panel.example.com" export UADMIN_DB_PASS="your-mariadb-password" curl -fsSL https://enc-it.hr/uadmin/install-uadmin-from-release.sh | sudo -E bash
Putanje nakon instalacije
- Aplikacija panela: /home/uadmin/app → releases/current
- Skripte: /usr/local/uadmin/bin/
- Web root projekata: /web/public_html/<domena>/
- Shared (recovery, .env): /home/uadmin/shared/
Važno
Instalacija traje nekoliko minuta. Nakon završetka otvorite panel, promijenite admin lozinku i pokrenite Instalacije → stack wizard (PHP-FPM, MariaDB, Certbot…).
Pristup panelu
Panel je odvojen od web projekata — radi na portu 10001. Web stranice klijenata idu na standardne portove 80/443.
URL panela (primjer):
https://<hostname>:10001
Web projekt (primjer):
https://<domena>
Prvi login
Nakon instalacije koristite default račun — odmah promijenite lozinku u Postavke → Korisnici.
E-mail: admin@localhost Password: changeme
Datoteka s lozinkama
MariaDB i ostale generirane lozinke spremaju se u:
/home/uadmin/INSTALL-PASSWORDS.txt /root/uadmin-INSTALL-PASSWORDS.txt
SSL panela
U panelu: Postavke → SSL panela — Let's Encrypt certifikat za hostname panela (npr. panel.example.com:10001). Web projekti imaju zaseban SSL u modulu SSL po domeni.
Stack wizard
Prije prvog projekta pokrenite Instalacije → wizard: PHP-FPM verzije, MariaDB, Certbot, Adminer, vsftpd, UFW. Apache je obično već instaliran s panelom.
OTA ažuriranja panela
Panel se ažurira bez gubitka projekata. U Postavke → Ažuriranja unesite manifest URL (Enc IT kanal):
UADMIN_UPDATE_MANIFEST_STABLE=https://enc-it.hr/uadmin/stable.json UADMIN_UPDATE_MANIFEST_BETA=https://enc-it.hr/uadmin/beta.json UADMIN_UPDATE_MANIFEST_NIGHTLY=https://enc-it.hr/uadmin/nightly.json
Kanali
- stable — produkcijski release
- beta — testni release
- nightly — najnoviji build
Ažuriranje iz SSH-a
Isto radi i ručno (root):
sudo /usr/local/uadmin/bin/update-uadmin.sh update
Korisnici panela
Admin korisnici su odvojeni od FTP/MariaDB korisnika projekata. Upravljanje: Postavke → Korisnici (dodavanje, uloga, lozinka).
Recovery GUI (kad panel ne radi normalno)
Na http://<server>:10001/panel-recovery/ unesite token i resetirajte lozinku admin korisnika.
http://<server-ip-or-host>:10001/panel-recovery/
SSH — artisan (kad panel radi, ali ste izgubili lozinku)
Zamijenite email i novu lozinku (min. 8 znakova):
sudo -u uadmin php8.3-cli /home/uadmin/app/artisan tinker --execute="
\$u = App\Models\User::where('email', 'admin@localhost')->first();
\$u->password = 'NovaSigurnaLozinka123';
\$u->save();
echo 'OK: '.$u->email;
"
Novi admin korisnik (artisan)
Preferirajte Postavke → Korisnici u panelu. Za hitni slučaj preko SSH:
sudo -u uadmin php8.3-cli /home/uadmin/app/artisan tinker --execute="
App\Models\User::create([
'name' => 'Admin',
'email' => 'admin@example.com',
'password' => 'NovaSigurnaLozinka123',
'role' => 'admin',
]);
echo 'User created';
"
Recovery alati
Recovery radi i kad glavni panel vraća 503 (maintenance nakon OTA-a) ili se ažuriranje zaglavi. Alati su izvan Laravel releasea — ne gube se pri rollbacku.
Web GUI (port 10001):
http://<server-ip-or-host>:10001/panel-recovery/
Recovery token (SSH, root):
sudo cat /home/uadmin/shared/recovery-token
Token se kreira pri instalaciji/updateu. Bez tokena GUI neće prihvatiti akcije.
Interaktivni SSH izbornik (root):
sudo bash /usr/local/uadmin/bin/panel-recovery.sh
Što recovery može
- Status panela i popis release verzija
- Isključiti maintenance (503) — maintenance-off
- Rollback na prethodnu verziju ili switch-release --version X.Y.Z
- Repair symlinkova, recovery tokena i maintenance datoteka
- Stack repair — Nginx, Apache, PHP-FPM (recovery-stack.sh)
- Popis korisnika panela i reset lozinke (GUI ili recovery API)
CLI naredbe (root)
Sve naredbe za održavanje panela. Skripte su u /usr/local/uadmin/bin/.
update-uadmin.sh
sudo /usr/local/uadmin/bin/update-uadmin.sh status sudo /usr/local/uadmin/bin/update-uadmin.sh update sudo /usr/local/uadmin/bin/update-uadmin.sh list-releases sudo /usr/local/uadmin/bin/update-uadmin.sh rollback sudo /usr/local/uadmin/bin/update-uadmin.sh switch-release --version 1.0.104 sudo /usr/local/uadmin/bin/update-uadmin.sh maintenance-off sudo /usr/local/uadmin/bin/update-uadmin.sh maintenance-off --force-lock sudo /usr/local/uadmin/bin/update-uadmin.sh repair
panel-recovery.sh
Interaktivni izbornik — iste akcije kao recovery GUI, pogodno preko SSH bez preglednika.
sudo bash /usr/local/uadmin/bin/panel-recovery.sh
artisan (kao uadmin)
Laravel naredbe — uvijek iz current releasea:
cd /home/uadmin/app sudo -u uadmin php8.3-cli artisan migrate --force sudo -u uadmin php8.3-cli artisan config:cache sudo -u uadmin php8.3-cli artisan route:cache
Smoke test
Provjera panela nakon instalacije ili updatea:
sudo -u uadmin php8.3-cli /home/uadmin/app/bin/smoke-test.php
Česti problemi
419 PAGE EXPIRED pri loginu
CSRF/session cookie iz starog APP_URL ili istekla sesija. Očistite cookieje za domena:port panela ili otvorite privatni prozor. Provjerite da APP_URL u /home/uadmin/shared/.env odgovara URL-u u pregledniku (http/https, port).
503 nakon OTA ažuriranja
Panel je u maintenance modu. Recovery: maintenance-off ili recovery GUI → Isključi maintenance. Ako je update lock zapeo: maintenance-off --force-lock.
http://domena → 404, https radi
Konflikt uadmin-acme (panel SSL challenge) i uadmin-proxy-<domena> (web projekt) — oba slušaju :80. Rješenje: ukloniti sites-enabled/uadmin-acme kad postoji frontend proxy za tu domenu, ili ažurirati panel na verziju koja to automatski preskače.
Apache failed (no listening sockets)
Nakon instalacije bez web projekata Apache nema Listen port. Panel kreira idle Listen 127.0.0.1:8081. Pokrenite: sudo /usr/local/uadmin/bin/ensure-frontend-proxy.sh ili stack repair apache.
Login ne radi, curl s servera radi
Problem je u pregledniku (cookie/CSRF), ne na serveru. Provjera: curl -c /tmp/cj -b /tmp/cj login s 127.0.0.1:10001.
Što je uAdmin?
uAdmin (Ubuntu web Admin) razvijen je u Enc IT-u kao besplatan panel za programere i sistemaše koji hostaju više PHP/CMS projekata na Ubuntu serveru i trebaju granularnu konfiguraciju — ne samo klik-mi-ja-ne-znam-što.
Za koga
- Developere i DevOps/system administratore na vlastitom VPS-u ili dedicated stroju
- Agencije s više klijenata i /web/public_html layoutom
- Staging i produkcijska okruženja prije migracije na veći stack
Tehnologije
Laravel, Nginx, Apache, PHP-FPM, MariaDB, Certbot, UFW, vsftpd. Ubuntu 24.04.
Izvorni kod: github.com/lahorenc/uadmin