Bladwijzer Handleiding Naar Bladwijzer →

Handleiding › Installatie

Online zetten met Coolify

Bladwijzer installeren op je eigen server met Coolify: de applicatie, de database, het domein, de handleiding op docs.bladwijzer.eu en back-ups.

Bladwijzer is één Node.js-applicatie met een PostgreSQL-database. Met Coolify zet je ze in een kwartier online.

De applicatie

  1. Maak in Coolify een Application vanuit de Git-repository, met build pack Dockerfile. Poort: 3000.
  2. Voeg een persistent storage toe met doelpad /data: daar staan de foto’s en bijlagen.
  3. Maak een database (zie Database) en vul de omgevingsvariabelen in, minstens: DATABASE_URL, PUBLIC_URL, CONTACT_EMAIL en APP_SECRET.
  4. Koppel je domein, bv. https://bladwijzer.eu. HTTPS is nodig voor GPS en om de app op een gsm te installeren.
  5. Deploy. Daarna maak je jezelf beheerder in de Terminal van de applicatie: npm run make-admin -- <gebruikersnaam>.

De handleiding op een eigen domein

De handleiding draait in dezelfde applicatie: er is geen tweede deployment nodig.

  1. Maak bij je DNS-beheerder een record voor docs: een A-record naar het IP-adres van je server, of een CNAME naar je hoofddomein.
  2. Zet in Coolify bij de applicatie onder Domains beide domeinen, gescheiden door een komma: https://bladwijzer.eu,https://docs.bladwijzer.eu. Coolify vraagt dan ook voor docs een certificaat aan.
  3. Zet de omgevingsvariabele DOCS_URL=https://docs.bladwijzer.eu en deploy opnieuw.

Daarna opent docs.bladwijzer.eu de handleiding, en gaat bladwijzer.eu/docs daar automatisch naartoe. Zonder DOCS_URL staat de handleiding op /docs.

Tip

Meld de handleiding apart aan bij Google Search Console, met de sitemap https://docs.bladwijzer.eu/sitemap.xml.

Na de eerste deploy

  1. Mailkoppeling instellen en een testmail sturen.
  2. De gegevens van de uitbater invullen.
  3. Tweestapsverificatie aanzetten voor je beheerdersaccount.
  4. Eventueel GitHub en Teams koppelen voor foutmeldingen.
  5. Een statuspagina met Uptime Kuma die je waarschuwt als de site of de database plat ligt.
  6. Eventueel bezoekersstatistieken zonder cookies met Umami of Plausible.

Back-ups

  • Database: Coolify maakt back-ups volgens schema (of pg_dump). Bij Supabase: kijk bij Database › Backups wat je plan bewaart.
  • Bestanden: het /data-volume (foto’s en bijlagen).

Bijwerken

Elke push naar de hoofdbranch kan Coolify automatisch deployen. De database wordt bij het opstarten vanzelf bijgewerkt (genummerde migraties). Nieuwe versies van de app komen bij gebruikers na het herladen van de pagina.

Bijgewerkt op 2026-10-01