Soorten services
Een project bestaat uit services. Elke service heeft een naam: kleine letters, cijfers en streepjes, beginnend met een letter, maximaal 30 tekens. De namen supabase en shared zijn gereserveerd.
Web service
Section titled “Web service”Een app of API met een eigen adres (https://<service>-<ref>.apps.hoststuff.nl), uit een GitHub-repository of een image.
- HostStuff geeft de variabele
PORTmee (standaard 8080) en stuurt verkeer naar die poort. Kies een andere poort in de wizard als je app vast op bijvoorbeeld 3000 luistert. Toegestaan: 1024 tot 65535. - Replica’s: 0 tot 5 kopieën naast elkaar (standaard 1). Meer replica’s geven meer capaciteit en geen onderbreking als er één herstart.
- Optioneel een eigen startcommando.
Statische site
Section titled “Statische site”HTML of een single-page app (bijvoorbeeld Vite + React of Astro). HostStuff bouwt de site en serveert de bestanden zelf. Je krijgt hetzelfde adres als bij een web service, en ook eigen domeinen werken.
Worker
Section titled “Worker”Achtergrondwerk zonder adres, voor iets dat altijd moet draaien: een queue-consumer, een bot, een sync-proces. Een worker die stopt, wordt opnieuw gestart. Stopt hij steeds, dan staat hij op Crasht steeds.
Cronjob
Section titled “Cronjob”Een taak die op vaste tijden draait en dan stopt, zoals een nachtelijke export.
- Het schema is een gewone cron-regel met vijf velden, bijvoorbeeld
0 3 * * *(elke nacht om 3:00 UTC). De wizard heeft voorbeelden. - Een run mag standaard 1 uur duren (instelbaar van 1 minuut tot 24 uur).
- Er loopt nooit meer dan één run tegelijk.
- De status laat het schema en de uitkomst van de laatste run zien.
Postgres
Section titled “Postgres”Een eigen PostgreSQL-database, met back-ups en point-in-time herstel. Zie Postgres.
Valkey (Redis)
Section titled “Valkey (Redis)”Een snelle key-value store voor caches, sessies en wachtrijen, compatibel met Redis. Zie Valkey.
Supabase
Section titled “Supabase”Een complete Supabase-stack in je project. Er kan één Supabase-stack per project zijn. Zie Supabase op HostStuff.
Uit een image
Section titled “Uit een image”Een web service, worker of cronjob kan ook een kant-en-klaar image draaien. Dat image moet uit de registry van HostStuff komen (in Amsterdam). Een image van elders, bijvoorbeeld van Docker Hub, haal je binnen met een build: een repository met alleen een Dockerfile met FROM <image>.
Wat elke service meekrijgt
Section titled “Wat elke service meekrijgt”| Variabele | Waarde |
|---|---|
HOSTSTUFF_PROJECT |
de ref van het project |
HOSTSTUFF_SERVICE |
de naam van de service |
PORT |
de poort (alleen web en statisch) |
Services in hetzelfde project bereiken elkaar intern; andere projecten niet.