Memship Documentation

Documentation for self-hosting operators, organization admins, and members.

Languages. Operator/self-hosting docs are written in English (the audience is developers and system administrators, often international). The admin and member guides are Spanish-first (.es.md), since the people running a club and its members are primarily Spanish-speaking; Catalan (.ca.md) and English (.md) translations are added on demand.

Getting started

New to Memship? Start here.

• Quick start — try Memship with a single command (EN)
• Installation — production Docker install (EN)
• First-time setup — create your admin and organization (EN)

Self-hosting (operators)

Running Memship on your own server.

• Configuration reference — every environment variable (EN)
• Email delivery — SMTP or Resend (EN)
• Backups & restore (EN)
• Upgrading — image tags and migrations (EN)
• Troubleshooting — when something will not start (EN)
• Reverse proxy & TLS — the stack ships a Caddy that obtains and renews certificates on its own. Set up in Installation, tuned via SITE_ADDRESS in the Configuration reference
• Payment providers (Stripe, Redsys/Bizum) — planned

Development (contributors)

Working on Memship itself.

• Local development environment — the dev stack, commands, seeding and the test suites (EN)
• Contributing — branching, versioning and how a release is cut (EN)

Guía del administrador (admin guide)

Para el personal que gestiona la organización desde el panel de administración.

• Introducción — roles, navegación y panel (ES)
• Socios — ciclo de vida, tipos de membresía, grupos (ES)
• Actividades — inscripciones, modalidades, descuentos (ES)
• Pagos y recibos — recibos, cuotas, IVA, pago en línea (ES)
• Domiciliación SEPA — mandatos y remesas (ES)
• Comunicaciones — anuncios a los socios (ES)
• Carné digital — carné QR y control de acceso (ES)
• Campos de perfil — campos personalizados (ES)
• Informes y panel — panel, resumen anual, exportaciones (ES)
• Configuración — organización, facturación, automatizaciones (ES)

Guía del socio (member guide)

Para las personas socias que usan el portal.

• Tu cuenta y tu perfil — acceso, perfil, idioma, foto (ES)
• Actividades — inscribirse, lista de espera (ES)
• Pagos y recibos — mis recibos, pagar online, forma de pago (ES)
• Carné digital — carné QR (ES)

Reference

• Roles y permisos (ES)
• FAQ — planned
• Glossary — planned

Simple Bookings (reserva de espacios) ships in the released images — /api/v1/bookings is in the API and the setup command seeds spaces, slots and a waitlist — but it has no admin or member guide page yet. That is a documentation gap, not a missing feature.

Contributing to the docs

• Docs live with the code. When a feature PR changes behaviour, update its page in the same PR. Each admin/member guide page maps 1:1 to a feature module in the app.
• Keep heading anchors stable. In-app help links point at specific headings (e.g. admin-guide/activities#lista-de-espera). Renaming a heading breaks those links, so change anchors deliberately.
• Plain Markdown, tool-agnostic. These files render on GitHub today and can be published by a docs-site generator later without rework. Avoid tool-specific syntax.