Condui Community installeren en bouwen

Lokale installatie via Docker, Podman of broncode.

Condui Community is de zelfgehoste, lokale editie van Condui. Ze werkt zonder account, database of beheerde Condui-dienst. Je kunt de broncode zelf bouwen en de toepassing op je eigen computer of server draaien.

De Community-editie bewaart projecten in de browser van het toestel waarop je werkt. Gedownloade Condui-projectarchieven zijn in beide richtingen compatibel met de gehoste versie.

Bekijk de broncode van Condui Community op GitHub.

Welke installatiemethode kies je?

Het meegeleverde Dockerfile bouwt een standaard OCI-containerimage. Andere OCI-compatibele containertools kunnen het image ook bouwen, maar Docker en Podman zijn de geteste routes.

Vereisten

Voor Docker Compose of Podman heb je nodig:

• Git, of een gedownloade kopie van de repository;
• Docker met de Compose-plugin, of een recente Podman-installatie;
• een vrije lokale poort, standaard 8080; en
• een moderne browser.

Voor een rechtstreekse broncodebuild heb je Node.js 24 en npm nodig. Er is geen Supabase-project, cloudaccount of aparte database nodig.

Installeren met Docker Compose

1. Haal de repository op en open de projectmap:

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

1. Bouw en start de container:

docker compose up --build -d

1. Open http://localhost:8080. De startpagina van Condui Community verschijnt zodra de container klaar is.

1. Controleer indien nodig de status of logs:

docker compose ps
docker compose logs -f

Stop de toepassing met:

docker compose down

Installeren met Podman

Bouw eerst het OCI-image:

podman build -t condui-community:local .

Start daarna de container:

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

Open http://localhost:8080. Druk op Ctrl+C om de container te stoppen. Met Podman Compose kun je ook het meegeleverde compose.yaml gebruiken.

Bouwen en starten vanuit de broncode

Controleer eerst dat Node.js 24 actief is:

node --version

Installeer de vastgelegde afhankelijkheden, bouw de productieversie en start de lokale server:

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

Open daarna http://localhost:8080. De lokale server levert zowel de webtoepassing als de lokale conversie-endpoints voor ondersteunde planbestanden.

Bijwerken

Haal een nieuwe Community-snapshot op en bouw de container opnieuw:

git pull
docker compose up --build -d

Maak vóór een update een projectarchief van belangrijke projecten. De ondersteunde archieven worden bij het openen gemigreerd, maar een eigen back-up blijft de veiligste herstelmogelijkheid.

Projectopslag en back-ups

Projecten staan in de browseropslag, niet in de container. Het vervangen of opnieuw bouwen van de container wist die browseropslag normaal niet. De browser beschouwt elke combinatie van protocol, hostnaam en poort wel als een aparte oorsprong. Een overstap van localhost:8080 naar een andere hostnaam of poort kan daarom een lege projectlijst tonen.

Download belangrijke projecten regelmatig als Condui-projectarchief en bewaar ze op een locatie waarvan je een back-up maakt. Een PDF is een einddocument en bevat in de Community-editie geen ingebed bewerkbaar project.

Geen beheerde back-up of ondersteuning

Een Community-installatie heeft geen beheerde cloudopslag, herstelservice of officiële supportgarantie. Wie de installatie beheert, is zelf verantwoordelijk voor updates, bereikbaarheid en back-ups.

Veelvoorkomende problemen

• Poort 8080 is al in gebruik: wijzig in compose.yaml bijvoorbeeld 8080:8080 naar 8081:8080 en open daarna http://localhost:8081.
• De broncodebuild weigert te starten: controleer dat node --version versie 24 toont.
• De projectlijst lijkt leeg: open de toepassing opnieuw met exact dezelfde hostnaam en poort, of importeer een eerder gedownload projectarchief.
• De container stopt tijdens het bouwen: bekijk docker compose logs en controleer of Docker voldoende geheugen en vrije schijfruimte heeft.