Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

Self-hosting the full stack outside Cloudflare — working Miniflare-based deployment, offering fixes upstream

Aperta
  • Qualcosa non va?
#352 3 commenti 3 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
4/5
Tempo stimato
3-5 giorni
Idoneità per principianti
45/100
Tipo di issue
Funzionalità
Chiarezza
Abbastanza chiara
Stato di attività
Tranquilla
Stack tecnologico
clickhouse, docker, postgresql, typescript
Ambito
devops, documentation, infrastructure

Direzione di ricerca

Start by checking apps/web/Dockerfile and .dockerignore, then compare the api and compose Docker references with the files currently in the repository. Ask maintainers which pieces they want pursued before taking on the Miniflare deployment path. Done looks like an agreed scope, working Docker builds for any accepted fixes, and documentation if the self-host deployment path is accepted.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

We run Maple fully self-hosted (no Cloudflare, no Tinybird): vanilla ClickHouse per docs/self-hosted-clickhouse.md with the prebuilt collector, plus the three workers (api, alerting, electric-sync) running under Miniflare in a single container, Hyperdrive bound to a local Postgres 17, Electric fronted by the electric-sync worker, drizzle migrations on boot, chat/AI-triage on the OpenRouter fallback. It's validated end-to-end (auth → Electric shapes → ClickHouse queries) and lives at tlvenn/maple (deploy/workerd/).

Along the way we found the in-repo Docker path has drifted: apps/api/Dockerfile runs bun run start which no longer exists, docker-compose.yml references apps/alerting/apps/electric-sync Dockerfiles that aren't in the tree, and apps/web/Dockerfile can't build because .dockerignore excludes packages/browser/packages/effect-sdk and @maple-dev/clickhouse-builder's dist is never built (also @maple-dev/browser is imported by the web app but not declared, so it only resolves via hoisting).

If there's interest, I'd like to upstream this in pieces:

  1. the web Dockerfile/.dockerignore fixes — happy to open that PR immediately;
  2. cleaning up or fixing the stale api/compose Docker references — your call whether those should be fixed or removed;
  3. the Miniflare runtime as an official self-host deployment path, with docs.

No hard feelings if (3) isn't the direction you want — even just (1)+(2) would help other self-hosters.

Lingua principale
TypeScript
Stelle
1.8k
Fork
120
Merge medio
8h 11m
PR unite (30g)
667

Preparare l'ambiente

Questo progetto non fornisce container di sviluppo, Dockerfile né guida per i contributori, quindi l'ambiente è a tuo carico: parti dal suo README e consulta la nostra guida al primo contributo per i passaggi generali.

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di MapleTechLabs/maple

Tutte le issue di MapleTechLabs/maple

Issue simili

Altre issue su TypeScript

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.