Je app starten (NL)

Wil je zelf zien wat het team gebouwd heeft? Met één klik start Coodoo je app.

Starten

Klik bovenin op App starten of open het venster App (onder). De knop laat zien wat er gebeurt:

Knop	Betekenis
App starten	Klaar om te starten
Installeren…	Coodoo installeert eerst de onderdelen die je app nodig heeft
App start…	De app wordt opgestart
App draait	De app werkt; klik om het venster te openen

Een website opent met Openen in je browser. Een desktop-app opent vanzelf in zijn eigen venster.

In het venster App zie je ook wat de app laat zien terwijl hij draait (de uitvoer). Verder: Stoppen en Opnieuw starten. Sluit je Coodoo af, dan stopt je app ook.

Hoe weet Coodoo hoe je app start?

Elk project start anders. Coodoo zoekt het in deze volgorde uit:

1. De Startopdracht die je zelf invulde in het venster App;
2. wat het team opschreef in .coodoo/run.json;
3. wat het project zelf zegt: de scripts in package.json, of een Django-, Rust- of Go-project.

Je ziet wat Coodoo gevonden heeft als Automatisch: npm run dev (bijvoorbeeld).

Laat de agent het uitzoeken

Vindt Coodoo niets, of klopt het niet? Klik op Laat Claude het uitzoeken (of Codex). De agent leest je project en stelt een startopdracht voor, die je ziet bij Gevonden:.

Zelf instellen

Weet je het zelf, vul dan bij Startopdracht de opdracht in, bijvoorbeeld npm run dev. Laat het veld leeg om Coodoo het weer zelf te laten bepalen.

Delen met anderen (Cloudflare Tunnel)

Wil je dat iemand anders je website meetest, ook als die niet op jouw netwerk zit? Start je app en klik in het venster App bij Delen op Delen via tunnel. Coodoo maakt via Cloudflare een https-adres dat naar je app op jouw computer wijst. Met het knopje ernaast kopieer je het adres, zodat je het kunt doorsturen.

• Iedereen met het adres kan je app gebruiken zolang de tunnel aanstaat. Stuur het dus alleen naar mensen die mogen meekijken.
• De tunnel stopt met Tunnel stoppen, als je app stopt en als je Coodoo afsluit.
• De eerste keer installeert Coodoo het programma van Cloudflare. Het komt van Cloudflare zelf en Coodoo controleert of de download klopt.
• Alleen een website kun je delen; een desktop-app niet.

Bij Tunnel instellen… kies je tussen:

Soort	Wat je krijgt
Snel adres	Geen account nodig. Je krijgt elke keer een nieuw adres op trycloudflare.com. Handig om even snel iets te laten zien.
Willekeurig subdomein	Elke keer een nieuw adres op je eigen domein, zoals k7x2-dienstkaartje.mijnsite.nl. Het DNS-record verdwijnt weer als je app stopt. Hiervoor koppel je je Cloudflare-account.
Vast adres	Je eigen adres, zoals test.mijnsite.nl, dat steeds hetzelfde blijft. Hiervoor heb je een (gratis) Cloudflare-account met je eigen domein nodig; je voegt ze toe in Instellingen → Cloudflare.

Willekeurige subdomeinen

Koppel je je Cloudflare-account, dan kan Coodoo een app delen op een willekeurig subdomein van je eigen domein, zoals k7x2-dienstkaartje.mijnsite.nl.

• Elk project krijgt de eerste keer een eigen tunnel in je account. Die tunnel gebruikt Coodoo daarna steeds opnieuw.
• Bij Delen via tunnel maakt Coodoo een nieuw subdomein en zet er een DNS-record voor neer dat naar de tunnel van het project wijst.
• Stopt je app (of de tunnel, of Coodoo), dan haalt Coodoo dat DNS-record meteen weer weg. Bleef er een staan, bijvoorbeeld na een crash of zonder internet, dan ruimt Coodoo het op bij de volgende start.
• Meerdere projecten kunnen tegelijk gedeeld worden, elk op een eigen subdomein.

Je account koppelen doe je in Instellingen → Cloudflare, bij Cloudflare-account:

1. Klik op API-tokens openen, dan op Create Token, en bij Custom token op Get started.
2. Geef het token een naam en voeg bij Permissions drie regels toe: Account · Cloudflare Tunnel · Edit, Zone · DNS · Edit en Zone · Zone · Read.
3. Kies bij Zone Resources de domeinen die Coodoo mag gebruiken. Klik op Continue to summary en Create Token.
4. Kopieer het token, plak het in Coodoo en klik op Koppelen. Coodoo bewaart het versleuteld op deze computer.

Daarna kies je per project bij Tunnel instellen… de optie Willekeurig subdomein op met je domein.

Coodoo verwijdert alleen DNS-records die het zelf heeft gemaakt; zie Failsafes. Je andere records en tunnels blijven altijd staan.

Vaste adressen

Vaste adressen beheer je op één plek: Instellingen → Cloudflare. Daar kun je er zoveel toevoegen als je wilt. Per project kies je bij Tunnel instellen… welk adres het gebruikt, of je houdt het snelle adres.

Een vast adres toevoegen:

1. Klik in Instellingen → Cloudflare op Vast adres toevoegen en daarna op Cloudflare openen. Ga naar Zero Trust → Networks → Tunnels, klik op Create a tunnel, kies Cloudflared en geef de tunnel een naam.
2. Cloudflare toont een opdracht om de tunnel te installeren. Kopieer die hele opdracht en plak hem in Coodoo. Coodoo haalt de sleutel eruit en bewaart hem versleuteld op deze computer; je ziet hem daarna nooit meer terug.
3. Klik in Cloudflare op Next en voeg een adres toe: kies een subdomein en je domein. Bij Service kies je HTTP, met als URL het adres dat Coodoo toont (bijvoorbeeld localhost:47801).
4. Vul hetzelfde adres in Coodoo in, geef het eventueel een naam en klik op Opslaan.

Elk vast adres krijgt van Coodoo een eigen poort op je computer (localhost:47801, 47802…). Coodoo stuurt die poort door naar de app van het project dat het adres op dat moment gebruikt. Zo hoef je in Cloudflare niets te veranderen als je een adres aan een ander project geeft. Eén adres kan wel maar door één project tegelijk gebruikt worden.

Coodoo kiest bij het toevoegen een poort die op dat moment vrij is. Gebruikt later een ander programma die poort, dan zie je in Instellingen → Cloudflare een waarschuwing met de knop Andere poort. Coodoo zoekt dan een vrije poort en vertelt welk adres je in Cloudflare bij Service URL moet zetten. Dat laatste moet je zelf doen, want die instelling staat in Cloudflare.

De lijst met adressen gaat via je instellingen mee naar je andere computers.

Op al je computers

Het API-token en de sleutels van je vaste adressen kunnen versleuteld mee naar je andere computers. Dat gaat net als bij de gedeelde kluis van een project, maar dan voor Coodoo zelf.

1. Klik in Instellingen → Cloudflare, bij Op al je computers, op Delen met mijn andere computers. De sleutels gaan versleuteld naar je privé-repository coodoo-settings (settings/global/vault.enc).
2. Op je andere computer klik je op dezelfde plek op Deze computer koppelen. Er verschijnt een code.
3. Keur die computer goed op de eerste computer, nadat je hebt gecontroleerd dat de code op beide schermen gelijk is.

Daarna gaan nieuwe en gewijzigde sleutels vanzelf naar al je gekoppelde computers. Op GitHub staat niets leesbaars. Een computer die je niet zelf hebt gekoppeld, kan de sleutels niet openen.

Zet Tunnel vanzelf starten zodra de app draait aan als je de tunnel altijd wilt hebben wanneer je app draait.

Ontbreekt er iets?

Heeft je app Node.js, Python of Java nodig en staat dat niet op je computer, dan zie je dat bij Benodigdheden. Coodoo installeert het met één klik.

Mist je app een instelling of sleutel (een .env-bestand), dan zie je dat hier met de knop Invullen; zie Instellingen van je app.

Heeft je app eenmalig iets nodig voor de eerste start (zoals de database klaarzetten), dan vindt de agent dat ook en zie je een knop Laat Coodoo dit doen; zie Opdrachten.