Naar hoofdinhoud
Installatiehandleidingen voor Studio Mijn bedrijf gebruikt al Cloudflare

Studio toevoegen aan het Cloudflare-account van je bedrijf

Wordt het domein van je bedrijf al beheerd in Cloudflare, dan kan Studio in datzelfde account komen, naast je website. Studio krijgt een eigen gratis workers.dev-adres en, als je wilt, een nieuw subdomein van je domein. Je website en de DNS-records ervan blijven precies zoals ze zijn.

Het beste voor
Bedrijven waarvan het domein al in Cloudflare wordt beheerd.
Dit heb je nodig
Maxisnap voor Windows of Mac, ingelogd met het account dat Studio heeft; inloggegevens voor het Cloudflare-account van je bedrijf waarmee je Workers kunt toevoegen, of de persoon die dat account beheert; en een AI-codeerassistent op je computer, of een terminal met Node.js 20 of nieuwer.
Tijd
Ongeveer 20 minuten de eerste keer.
Dit krijg je
Studio op een eigen workers.dev-adres, plus een nieuw subdomein zoals snaps.yourcompany.com als je dat wilt. Je website blijft precies zoals die is.
Kosten
Studio is gebouwd om te draaien op het gratis abonnement van Cloudflare. Cloudflare publiceert het actuele gratis quotum en de prijzen van R2.

Wat Studio toevoegt en wat er ongemoeid blijft

Studio voegt toe

  • De Studio-app zelf (Cloudflare noemt dit een “Worker”)
  • Een opslagruimte voor je opnames (een “R2-bucket”)
  • Een kleine database voor je bibliotheek en je team (“D1”)
  • Het adres van Studio op workers.dev, plus één nieuw subdomein als je er een kiest
  • De workers.dev-naam van je account, als dat er nog geen heeft (één naam voor het hele account)

Studio laat met rust

  • Je website en de bestanden ervan
  • De bestaande DNS-records van je domeinen
  • Elke andere Worker, opslagruimte of database
  • Je facturering en je andere accountinstellingen

Als een naam al in gebruik is, kiest Studio een andere of vraagt Studio je dat te doen; er wordt niets vervangen wat er al staat.

Als iemand anders je Cloudflare of je website beheert, overleg dan eerst met die persoon. Sommige bedrijven hebben regels over wie diensten aan het bedrijfsaccount mag toevoegen, of plaatsen een inlogpagina voor elk subdomein, wat de uploads van Maxisnap zou blokkeren.

Deel het technische document met de persoon die je Cloudflare beheert.

Controleer of de opslag aanstaat

Studio slaat je opnames op in Cloudflare R2. Log in op het Cloudflare-account van je bedrijf en controleer dit één keer:

  1. Open in het Cloudflare-dashboard Storage & databases → R2 → Overview.
  2. Als Cloudflare aanbiedt om R2 toe te voegen, rond dan de afrekening af. Ben je niet de eigenaar van de facturering van het account, vraag die persoon dan om deze stap uit te voeren.

Het dashboard van je Studio laat zien hoeveel opslag je gebruikt. In de R2-documentatie van Cloudflare, gelezen in oktober 2026, staat dat je gratis met R2 kunt beginnen, met inbegrepen gratis maandelijks gebruik, en dat je maandelijks wordt gefactureerd voor je gebruik.

Wat je ziet De R2-overzichtspagina van Cloudflare, met een knop om R2 aan je account toe te voegen en, als Cloudflare erom vraagt, een formulier voor een betaalkaart of PayPal.

Haal Studio naar je computer

  • Op Windows: open in Maxisnap Instellingen → Account → Installatiewizard van Maxisnap Studio, klik op “Aan de slag” en dan op “Dashboard downloaden”. Maxisnap slaat de Studio-ZIP op in je map Downloads en opent die map.
  • Op een Mac: open in Maxisnap Settings → Welcome & Help → Studio Setup Guide, klik op “Get Started” en dan op “Download Dashboard”. Maxisnap slaat de Studio-ZIP op in je map Downloads.

Pak de ZIP uit. Klik op Windows met de rechtermuisknop op het bestand en kies “Alles uitpakken”. Dubbelklik op een Mac op het bestand.

Wil je vanaf het begin je logo en kleuren? Dubbelklik op “Maxisnap Studio - Start Here.html”, ontwerp je huisstijl en klik op “Lock in my branding”. Je assistent gebruikt die dan. Of sla dit over en wijzig de huisstijl later in je dashboard onder Branding.

Wat je ziet De uitgepakte Studio-map: drie mappen (cloudflare, docs en snaps), de pagina Start Here en de instructies voor AI-assistenten.

Bepaal het adres

Studio krijgt altijd een workers.dev-adres, dat vanaf het begin werkt. Je kunt ook een nieuw subdomein van je domein toevoegen, zoals snaps.yourcompany.com, als het domein actief is in dit Cloudflare-account.

Je adres ziet er zo uit: snaps.yourcompany.workers.dev

Je kunt later je eigen domein toevoegen zonder iets te verliezen.

Geef het aan je AI-assistent

  1. Open je AI-codeerassistent: Claude Code, Codex, Cursor of een andere die opdrachten op je computer kan uitvoeren.
  2. Kopieer de kant-en-klare instructies uit de handleiding over installeren met een AI-assistent, vervang de regel tussen punthaken door je Studio-map en plak ze erin.
  3. Zeg tegen je assistent dat je bedrijf al Cloudflare gebruikt en of je een subdomein wilt. Je assistent leest het instructiebestand in je Studio-map en legt elke stap uit voordat die wordt uitgevoerd.

Haal de kant-en-klare instructies op.

Maak een Cloudflare-sleutel aan wanneer je assistent erom vraagt

De deploy heeft toestemming nodig om in je account te werken. Die geef je met een Cloudflare API-token, dat voor deze ene taak werkt als een wachtwoord.

  1. Open in Cloudflare My Profile → API Tokens, klik op “Create Token” en kies ervoor om een aangepast token te maken.
  2. Voeg deze vier machtigingen toe: Account Settings Read, Workers Scripts Edit, Workers R2 Storage Edit en D1 Edit.
  3. Voeg voor een subdomein drie extra machtigingen toe: Zone Read, DNS Read en Workers Routes Read.
  4. Kies onder Account Resources het account van je bedrijf. Neem voor een subdomein onder Zone Resources je domein op.
  5. Klik op “Continue to summary” en daarna op “Create Token”. Cloudflare toont het token maar één keer, dus kopieer het meteen.
  6. Plak het token zelf in de terminal wanneer je assistent erom vraagt, niet in de chat.

Open de pagina API Tokens van Cloudflare.

In het technische document staat waar elke machtiging voor wordt gebruikt. Zodra je Studio draait, kun je het token verwijderen; voor het later bijwerken of verwijderen van je Studio heb je een nieuw token nodig.

Wat je ziet De tokenpagina van Cloudflare: een rij voor elke machtiging en onderaan een knop “Continue to summary”.

Controleer het plan en maak dan je Studio aan

Er wordt niets aangemaakt voordat je ja zegt. Je assistent maakt eerst het plan en laat het je zien. Onder “Will create” staan één Worker, één R2-bucket en één D1-database, plus je workers.dev-naam als die nieuw is en je subdomein als je er een hebt gekozen. Onder “Will not touch” staan je domeinen en DNS, je andere Workers, buckets en databases.

  1. Als het plan een probleem toont, zoals een naam die al in gebruik is, kies dan een andere naam en maak het plan opnieuw.
  2. Als het plan er goed uitziet, zeg je tegen je assistent dat hij door kan gaan. Stopt de deploy halverwege, dan gaat die bij het opnieuw uitvoeren van dezelfde opdracht verder, zonder iets dubbel aan te maken.
Wat je ziet Je assistent toont het plan: het adres van Studio, daarna “Will create”, “Will not touch” en eventuele waarschuwingen.

Bewaar je adminsleutel

  1. Als het klaar is, toont de deploy één keer het adres van je Studio en de bijbehorende adminsleutel. Bewaar de sleutel op een veilige plek, zoals je wachtwoordmanager. Je logt ermee in op je dashboard, en iedereen die hem heeft, kan je Studio gebruiken.
  2. De deploy schrijft ook een bestand met de naam deployment.json in de map cloudflare. Bewaar dat bestand, want het wordt later gebruikt bij het bijwerken of verwijderen van je Studio.

Koppel Maxisnap en probeer het uit

  • Maxisnap voor Windows: open Instellingen → Account → Installatiewizard van Maxisnap Studio, klik op “Aan de slag”, dan op “Volgende” tot je bij stap 4 komt, “Koppel Maxisnap”. Plak het adres en de sleutel van je Studio, klik op “Verbinding testen”, dan op “Volgende” en op de laatste pagina op “Voltooien en opslaan”. De adminsleutel uit de installatie werkt, en een uploadcode uit People & access in je dashboard ook.
  • Maxisnap voor Mac: open Settings → Welcome & Help → Studio Setup Guide en kies “I already have a dashboard”. Plak het adres en de sleutel van je Studio, klik op “Test Connection”, dan op “Next” en dan op “Finish & Save”.

Leg iets vast en klik in de editor op “Uploaden”. Op Windows legt Ctrl+Alt+7 een gebied vast en uploadt het meteen. De deellink komt op je klembord terecht.

Maxisnap voor Windows en Maxisnap voor Mac sturen elke upload in één verzoek naar een Cloudflare-Studio, die per bestand maximaal 25 MB accepteert.

Volgende stappen: voeg je team toe in het dashboard onder People & access (iedereen krijgt een eigen code en rol), en wijzig je logo of kleuren op elk moment onder Branding.

Als er iets misgaat

Het subdomein is al in gebruik

snaps.yourcompany.com is already in use (it has DNS records). Pick a name that isn’t used yet; Studio never changes existing DNS.

Die naam verwijst al ergens naartoe, dus Studio laat die met rust. Kies een subdomein dat nog niet in gebruik is, zoals studio of share.

Een Worker-route dekt het subdomein al

The Worker route “*.yourcompany.com/*” on yourcompany.com already covers snaps.yourcompany.com, so Studio would not receive its traffic. Pick another name.

Een andere Worker in je account beantwoordt elk subdomein dat bij die route past, waardoor Studio zijn eigen bezoekers nooit zou zien. Kies een naam buiten de route, of vraag het aan de persoon die de route heeft ingesteld.

Studio kan je domein niet vinden

That domain is not in this Cloudflare account.

Het domein staat in een ander Cloudflare-account, of het token kan het niet zien. Maak het token aan in het account waarin je domein staat, met Zone Read, DNS Read en Workers Routes Read voor dat domein.

Je domein is gemarkeerd als “not active yet”

yourcompany.com is not active on Cloudflare yet, so snaps.yourcompany.com will not work until it is.

Cloudflare reageert nog niet op het domein, meestal omdat de nameservers nog naar je oude provider wijzen. Gebruik voorlopig het workers.dev-adres; je kunt het subdomein later toevoegen zonder iets te verliezen.

Het nieuwe subdomein opent nog niet

Cloudflare kan even nodig hebben om een nieuw subdomein in te schakelen. Het workers.dev-adres werkt vanaf het begin, dus gebruik dat tot die tijd.

Uploads mislukken op het subdomein, maar het workers.dev-adres werkt

Een beveiligingsinstelling van Cloudflare op dat subdomein houdt Maxisnap tegen: Cloudflare Access (een inlogpagina vóór het adres), een WAF-regel of Bot Fight Mode. Vraag de persoon die je Cloudflare beheert om het Studio-subdomein door te laten. In het technische document staat wat je moet controleren.

Het plan meldt dat het de Worker-routes niet kon controleren

Studio could not check the Worker routes on yourcompany.com (the connection has no Workers Routes Read permission).

Voeg Workers Routes Read toe aan het token. Zonder die machtiging kan Studio niet zien of een andere Worker het nieuwe subdomein al opvangt.

De opslag is niet ingeschakeld

R2 storage is not turned on for this Cloudflare account yet.

Schakel R2 in het Cloudflare-dashboard in, zoals in stap 1, en vraag je assistent daarna om het plan opnieuw te maken.

De Studio-naam is al in gebruik

A Worker named “snaps” already exists in this account. Pick another name; Studio never replaces someone else’s Worker.

Geef je assistent een andere naam door, zoals snaps-yourcompany. Als de naam van een opslagruimte of database al bezet is, kiest de deploytool zelf de volgende vrije naam.

Cloudflare heeft een stap geweigerd

Cloudflare refused this step: the connection does not have permission for it. Reconnect Cloudflare and approve every permission Studio asks for.

Het token mist een machtiging. Maak een nieuw token aan met de machtigingen uit stap 5 en plak het opnieuw in de terminal wanneer je assistent erom vraagt.

De installatie is halverwege gestopt

Vraag je assistent om dezelfde deploy-opdracht opnieuw uit te voeren. De opdracht gaat verder waar hij is gestopt en maakt niets dubbel aan.

Je nieuwe adres opent nog niet

Studio did not come online in time (HTTP 404). Cloudflare can take a few minutes to publish a new address; try again shortly.

Alles is aangemaakt; Cloudflare is het adres nog aan het inschakelen. Wacht een paar minuten en open het adres daarna opnieuw.

Je bent je adminsleutel kwijt

Je assistent kan een nieuwe sleutel instellen. Die voert daarvoor deze opdracht uit vanuit de map cloudflare van je Studio-download, met een Cloudflare-token in de terminal. De opdracht toont de nieuwe sleutel één keer; koppel Maxisnap daarna opnieuw met die sleutel.

node deploy/cli.mjs update --record deployment.json --yes --new-admin-key

Grote video’s worden niet geüpload

Maxisnap voor Windows en Maxisnap voor Mac sturen elke upload in één verzoek naar een Cloudflare-Studio, die per bestand maximaal 25 MB accepteert.

Houd schermopnames onder die grootte, of kort ze in voordat je ze uploadt.

Maxisnap zegt dat de sleutel niet klopt

Kopieer de sleutel opnieuw van de plek waar je hem hebt bewaard, zonder spaties ervoor of erna. Controleer ook het adres: dat is het adres dat de installatie je liet zien, beginnend met https://.

Kom je er niet uit?

Mail ons en je krijgt antwoord van een mens, meestal binnen één werkdag. Met deze gegevens kunnen we in één keer antwoorden:

  • De installatieoptie die je hebt gekozen en de stap waar je op zit.
  • Een screenshot van het scherm, met de volledige tekst van een eventuele foutmelding.
  • Waar je Studio komt te staan: een nieuw of bestaand Cloudflare-account, of de naam van je webhostingbedrijf.
  • Je Maxisnap-versie: op Windows bij Instellingen en dan Info; op een Mac onder Maxisnap en dan About Maxisnap.

Stuur ons alsjeblieft niet je adminsleutel, een Cloudflare-sleutel of een wachtwoord. We hebben ze niet nodig om je te helpen.

Andere installatiehandleidingen