manfredsteger/polly repository overview

⁠Polly - Open-Source Polling & Scheduling Platform

Self-hosted Doodle/Calendly alternative for teams who need GDPR-compliant, cloud-independent coordination tools.

⁠Quick Start

docker pull manfredsteger/polly:beta

# Option 1: Docker Compose (recommended)
git clone --branch v0.1.0-beta.9 --depth 1 https://github.com/manfredsteger/polly.git
cd polly
cp .env.example .env
# Set POSTGRES_PASSWORD, SESSION_SECRET and ADMIN_PASSWORD to strong values
docker compose -f docker-compose.image.yml up -d
# Open http://localhost:3080

# Option 2: Docker Compose with an external database
git clone --branch v0.1.0-beta.9 --depth 1 https://github.com/manfredsteger/polly.git
cd polly
cp .env.example .env
# Set DATABASE_URL, SESSION_SECRET and ADMIN_PASSWORD in .env
docker compose -f docker-compose.image.external-db.yml up -d

# Option 3: Docker Run with external database
docker run -d \
  --name polly \
  -p 3080:5000 \
  -e DATABASE_URL=postgresql://user:pass@your-db:5432/polly \
  -e SESSION_SECRET=$(openssl rand -base64 32) \
  -e APP_URL=http://localhost:3080 \
  -v polly-uploads:/app/uploads \
  manfredsteger/polly:0.1.0-beta.9

Default Admin Login: admin / Admin123!

⁠Features

• 3 Poll Types: Schedule coordination, surveys, and organization/booking lists
• Real-Time Voting: Live results via WebSocket with fullscreen presentation mode
• Multi-Language: German and English with automatic browser detection
• Authentication: Anonymous, local email/password, and Keycloak OIDC (SSO)
• Email Notifications: Configurable reminders with customizable templates
• Data Export: CSV, PDF, ICS calendar feed, and QR code sharing
• Admin Dashboard: User management, branding, security scanning, email templates
• WCAG 2.1 AA: Automatic color contrast auditing and correction
• ClamAV Integration: Optional virus scanning for file uploads
• AI Poll Assistant: Create polls via natural language with GWDG SAIA (OpenAI-compatible API)
• Voice Input: Speech-to-text for AI chat using Whisper
• GDPR Compliant: All data stays on your server, no external tracking

⁠Available Tags

⁠Environment Variables

⁠Required

⁠Application

⁠Branding (Optional)

These values can also be edited from the Admin Panel after first start. When set via ENV, the corresponding form field becomes read-only.

⁠Email (Optional)

⁠Keycloak SSO (Optional)

⁠ClamAV Virus Scanning (Optional)

Start with ClamAV:

CLAMAV_ENABLED=true CLAMAV_HOST=clamav docker compose --profile clamav up -d

⁠AI Assistant (Optional)

⁠Docker Compose

docker-compose.image.yml starts the pinned public image together with PostgreSQL:

services:
  postgres:
    image: postgres:16-alpine
    volumes:
      - postgres_data:/var/lib/postgresql/data

  app:
    image: manfredsteger/polly:0.1.0-beta.9
    ports:
      - "3080:5000"
    volumes:
      - uploads_data:/app/uploads
    depends_on:
      postgres:
        condition: service_healthy

volumes:
  postgres_data:
  uploads_data:

Set POSTGRES_PASSWORD, SESSION_SECRET, and ADMIN_PASSWORD in .env before starting. Use the pinned version tag for production; :beta intentionally advances to the newest beta release.

The release image supports linux/amd64 and linux/arm64, making it suitable for compatible x86_64 and ARM64 Portainer or Synology Container Manager hosts.

⁠Data Persistence

The container runs as UID:GID 1001:1001 (nodejs). The uploads volume must be owned by this user, otherwise image uploads fail with EACCES (the container logs a [Uploads] WARNING at startup). Fix from the Docker host:

docker run --rm -v uploads_data:/data alpine chown -R 1001:1001 /data

⁠Health Check

curl http://localhost:3080/api/v1/health
# {"status":"ok","timestamp":"..."}

⁠Documentation

• Self-Hosting Guide⁠ — Full deployment instructions, reverse proxy, backups
• Release Notes⁠ — Changelog and download links
• Flutter Integration⁠ — Mobile app API documentation
• OpenAPI Spec⁠ — Complete API reference

⁠License

Polly is open-source software licensed under the MIT License⁠.