Terug naar de blog

Bee Flow naast Nextcloud installeren, stap voor stap

· Door Bee Flow · 4 min. lezen

Zo draai je Bee Flow op je eigen server en koppel je je Nextcloud eraan: wat Nextcloud eerst nodig heeft, de installer, de koppelcode en de wizard.

Two servers standing side by side, joined by one cable

De Bee Flow-app voor Nextcloud is een kleine container die Nextcloud via AppAPI start. Hij toont Bee Flow in Nextcloud en geeft verzoeken door. Bee Flow zelf installeert hij niet. De server, de database en de opslag vormen een aparte stack. Hier lees je hoe je die stack zelf draait en je Nextcloud eraan koppelt.

Laat je ons liever hosten, sla dan de eerste helft over en kies op de instelpagina voor Bee Flow Cloud. Op zelf hosten of laten hosten staan de twee opties naast elkaar. Wat de assistent kan zodra alles draait, lees je in een eerder stuk.

Eerst je Nextcloud nalopen

De app draait op Nextcloud 33, 34 en 35. Hij heeft AppAPI nodig met een Docker-deploydaemon, en voor een nieuwe installatie raden we HaRP aan. Met HaRP krijgt de reverse proxy voor je Nextcloud één regel extra, die alles onder /exapps/ naar de poort van HaRP stuurt (standaard 8780). Zonder die regel laadt de app niet. Nextcloud All-in-One regelt /exapps/ zelf zodra je HaRP aanvinkt in de interface.

De oudere Docker Socket Proxy-daemon werkt ook, maar dan loopt elk verzoek door de PHP van Nextcloud. Antwoorden in de chat komen dan pas aan het eind in één keer binnen, en lange verzoeken houden PHP-workers bezet.

Nextcloud moet via HTTPS bereikbaar zijn. De app draait als container, dus de host van je Nextcloud heeft Docker nodig. Op beheerde of gedeelde hosting zonder Docker bereikt Bee Flow je Nextcloud in plaats daarvan van buitenaf, per gebruiker, zonder de onderdelen die in Nextcloud zelf zitten.

De machine voor Bee Flow

Je hebt Docker met de Compose-plugin nodig, op een amd64-machine. Voor ARM worden de serverimages niet gebouwd. Het minimum is 2 CPU-kernen, 4 GB geheugen en 10 GB schijfruimte. Draait Nextcloud op dezelfde machine, dan komt dat er nog bij. De installer zet standaard ook de PII-guard en de onderwerpclassificatie aan. Die twee vragen samen ongeveer 7 GB geheugen. Reken voor de standaardinstallatie dus op ongeveer 11 GB.

Er moeten twee netwerkroutes werken. De connector moet het adres van Bee Flow kunnen bereiken, en de Bee Flow-server moet bij je Nextcloud kunnen.

De installer draaien

Op de Docker-host, als gebruiker die Docker mag gebruiken:

docker run --rm -it --network host \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /opt/beeflow:/opt/beeflow \
  ghcr.io/bee-flow/installer

Geef je de Docker-socket liever niet aan een container, dan staat dezelfde installer bij elke release ook als script klaar, met een checksum. Beide stellen dezelfde vragen: op welk adres Nextcloud deze machine bereikt (niet localhost), welke poorten je wilt, of je Nextcloud op een privéadres staat en hoe je organisatie heet. Met Enter neem je steeds de standaardwaarde.

Voordat hij iets start, controleert de installer Docker, de processor, vrije poorten, geheugen en schijfruimte. Ontbreekt er iets, dan stopt hij en zegt hij wat je moet doen. Aan het eind toont hij het adres van de server, het beheerderswachtwoord, een koppelcode die 15 minuten geldig is, en de geheimen die op je eigen host zijn aangemaakt. Bewaar het .env-bestand en een kopie van die geheimen. Zonder MASTER_ENCRYPTION_KEY is je opgeslagen data niet meer te lezen.

De installer serveert gewone http binnen je eigen netwerk. Gaat iemand Bee Flow van buiten dat netwerk gebruiken, zet dan eerst een reverse proxy met HTTPS voor beide poorten. Aan het eind van de installatie staan die stappen in beeld.

De app installeren en je server kiezen

Open in Nextcloud de Apps, zoek naar Bee Flow in de categorie AI en klik op Installeren. AppAPI haalt de connector op en start hem, meestal binnen 30 tot 60 seconden. In de bovenbalk verschijnt een bijtje.

Op dit moment is de app nog nergens mee verbonden. Open hem als Nextcloud-beheerder en je krijgt de instelpagina met twee kaarten: Bee Flow Cloud en een eigen server. Antwoordt er op dezelfde Docker-host een Bee Flow-server op de standaardpoort, dan biedt de pagina dat adres zelf aan.

Kies de eigen server, controleer het adres, vul de koppelcode in en maak verbinding. De pagina laat eerst zien wat er dan verstuurd wordt: de namen en e-mailadressen van je Nextcloud-beheerders, en het adres, het instance-id en de versie van de Nextcloud. Daarna vraagt de connector je server om /api/health. Komt er geen antwoord, dan wordt er niets opgeslagen.

Is de code intussen verlopen, maak dan in Bee Flow een nieuwe aan bij Nextcloud Sync, met Een nieuwe Nextcloud koppelen, en vul die op dezelfde pagina in. Opnieuw installeren hoeft niet.

De wizard afronden

Open Bee Flow nog een keer als beheerder. De wizard vraagt welke groepen gesynchroniseerd worden, welke koppelingen je aanbiedt en hoe streng de Privacy Shield moet zijn. Tot je hem hebt afgerond, zien andere gebruikers dat de inrichting nog bezig is. Daarna krijgen zij de app ook.

Wil je dat automatiseringen reageren op wat er in Nextcloud gebeurt, zet dan nu de app Webhook Listeners aan met occ app:enable webhook_listeners. In het stuk over Nextcloud-gebeurtenissen lees je wat dat oplevert.

Daarna

De connector werk je bij via de Apps-pagina van Nextcloud. De Bee Flow-stack niet, die werk je bij met dezelfde installer en het woord update aan het eind van de opdracht. Maak er ook een aparte back-up van, want de back-up van je Nextcloud bevat de database, de bestanden en het .env-bestand van Bee Flow niet.

Antwoordt de eigen Assistant van Nextcloud traag op jullie hardware, dan staat in Nextcloud Assistant traag of geen antwoord wat je eerst controleert. Past jullie opzet niet in deze route, vertel het ons.

#nextcloud #self-hosting