Instalați și construiți Comunitatea Condui

Instalare locală prin Docker, Podman sau cod sursă.

Condui Community este ediția locală, găzduită de utilizator, a Condui. Funcționează fără cont, bază de date sau serviciul Condui administrat. Puteți compila codul sursă și rula aplicația pe propriul computer sau server.

Ediția Community salvează proiectele în browserul dispozitivului pe care lucrați. Arhivele de proiect Condui descărcate sunt compatibile în ambele sensuri cu versiunea găzduită.

Consultați codul sursă Condui Community pe GitHub.

Ce metodă de instalare alegeți?

Fișierul Dockerfile inclus creează o imagine standard de container OCI. O pot crea și alte instrumente compatibile cu OCI, dar Docker și Podman sunt variantele testate.

Cerințe

Pentru Docker Compose sau Podman aveți nevoie de:

• Git sau o copie descărcată a depozitului;
• Docker cu pluginul Compose sau o instalare recentă Podman;
• un port local liber, implicit 8080; şi
• un browser modern.

Pentru o versiune sursă directă, veți avea nevoie de Node.js 24 și npm. Nu este necesar niciun proiect Supabase, cont cloud sau bază de date separată.

Instalați cu Docker Compose

1. Obțineți depozitul și deschideți folderul proiectului:

git clone https://github.com/Xoliul/condui-community.git
cd condui-community

1. Construiți și porniți containerul:

docker compose up --build -d

1. Deschideți http://localhost:8080. Pagina de pornire Condui Community va apărea după ce containerul este gata.

1. Verificați starea sau jurnalele dacă este necesar:

docker compose ps
docker compose logs -f

Opriți aplicația cu:

docker compose down

Instalați cu Podman

Creați mai întâi imaginea OCI:

podman build -t condui-community:local .

Apoi porniți containerul:

podman run --name condui-community --rm -p 8080:8080 condui-community:local

Deschide http://localhost:8080. Apăsați Ctrl+C pentru a opri containerul. Cu Podman Compose puteți folosi și compose.yaml inclus.

Construiți și rulați din codul sursă

Mai întâi verificați dacă Node.js 24 rulează:

node --version

Instalați dependențele capturate, construiți versiunea de producție și porniți serverul local:

npm ci --ignore-scripts
npm run build
npm start

Apoi deschideți http://localhost:8080. Serverul local furnizează atât aplicația web, cât și punctele finale locale de conversie pentru fișierele de plan acceptate.

Pentru a actualiza

Obțineți un nou instantaneu al comunității și reconstruiți containerul:

git pull
docker compose up --build -d

Creați o arhivă pentru proiectele importante înainte de actualizare. Arhivele acceptate sunt migrate la deschidere, dar păstrarea unei copii de rezervă proprii rămâne cea mai sigură metodă de recuperare.

Stocarea proiectelor și copiile de rezervă

Proiectele sunt păstrate în spațiul de stocare al browserului, nu în container. În mod normal, înlocuirea sau reconstruirea containerului nu șterge datele din browser. Totuși, browserul tratează fiecare combinație de protocol, nume de gazdă și port ca pe o origine separată. Prin urmare, trecerea de la localhost:8080 la alt nume de gazdă sau alt port poate duce la afișarea unei liste de proiecte goale.

Descărcați periodic proiectele importante ca arhive de proiect Condui și păstrați-le într-o locație pentru copii de rezervă. Un PDF este un document final și nu include un proiect editabil în Ediția Community.

Fără copii de rezervă gestionate sau asistență

O instalare Community nu oferă stocare administrată în cloud, serviciu de recuperare sau garanție oficială de asistență. Administratorul instalării este responsabil pentru actualizări, disponibilitate și copii de rezervă.

Probleme frecvente

• Portul 8080 este deja utilizat: în compose.yaml, de exemplu, schimbați 8080:8080 în 8081:8080 și apoi deschideți http://localhost:8081.
• Compilarea codului sursă refuză să pornească: verificați dacă node --version arată versiunea 24.
• Lista de proiecte apare goală: redeschideți aplicația cu exact același nume de gazdă și port sau importați o arhivă de proiect descărcată anterior.
• Containerul se oprește în timpul construirii: consultați docker compose logs și verificați dacă Docker are suficientă memorie și spațiu liber pe disc.
• Browserul afișează o pagină goală: deschideți consola pentru dezvoltatori a browserului. Aplicația Community rulează în browser; jurnalele Docker arată doar dacă serverul web local a pornit.