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

The install guide leaves PostgreSQL with Docker's 64MB of shared memory

Aperta Adatta ai principianti
  • Qualcosa non va?
#218 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
1/5
Tempo stimato
Meno di un'ora
Idoneità per principianti
88/100
Tipo di issue
Documentazione
Chiarezza
Specificata chiaramente
Stato di attività
Attiva
Stack tecnologico
docker-compose, postgresql
Ambito
documentation

Direzione di ricerca

La modifica riguarda docs/src/content/docs/self-hosting/install.md: il servizio postgres nell'esempio compose del passaggio 1 e l'esempio .env del passaggio 2. Confronta l'esempio con il compose.yaml di sviluppo per copiare esattamente la riga shm_size. Il lavoro è completo quando il servizio imposta shm_size: ${POSTGRES_SHM_SIZE:-256mb}, la pagina contiene una frase che spiega il limite di 64 MB e .env mostra una riga commentata # POSTGRES_SHM_SIZE=256mb.

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

Descrizione

documentation help wanted

What happens

The compose example in the self hosting install guide gives the postgres service no shm_size. Docker then gives the container its default /dev/shm of 64MB. PostgreSQL keeps its dynamic shared memory there. Parallel queries, such as a parallel hash join or a parallel bitmap scan, share their working memory through it, and the server statistics can grow into it too. Once it is full, a query fails with ERROR: could not resize shared memory segment ... No space left on device (SQLSTATE 53100). The postgres image's own documentation warns about this and suggests 256MB. The development compose.yaml already sets it.

What should happen

The postgres service in the install guide's compose example sets shm_size: ${POSTGRES_SHM_SIZE:-256mb}, the same line as the development compose.yaml. One sentence under the example says why: with only 64MB of /dev/shm, larger queries fail. The .env example in step 2 gains a commented # POSTGRES_SHM_SIZE=256mb line for anyone who needs more. Existing installs add the line and run docker compose up -d postgres, which recreates the container and keeps the data volume. No other docs page repeats the postgres service, so nothing else changes.

Where

  • docs/src/content/docs/self-hosting/install.md, the postgres service in the step 1 compose example
  • the same page, the .env example in step 2
Lingua principale
Go
Stelle
287
Fork
64
Merge medio
13h 19m
PR unite (30g)
62

Preparare l'ambiente

  • Include un Dockerfile o un file Docker Compose
  • Nessun modello di pull request
  • Nessuna guida per i contributori

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 gopherium/AlphOne

Tutte le issue di gopherium/AlphOne

Issue simili

Altre issue su Go

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.