readystack/discourse repository overview

⁠ReadyStack Discourse

Production-ready Discourse image with provenance tracking.

⁠Quick Start

docker run -d \
  --name discourse \
  -p 3000:3000 \
  -e DISCOURSE_HOSTNAME=localhost \
  readystack/discourse:v2026.1.0-CE-ubuntu24.04-r1

Wait 2-3 minutes for initialization, then open http://localhost:3000⁠

⁠Health Check

curl http://localhost:3000/srv/status
# Returns: ok

⁠Environment Variables

⁠API Quick Reference

⁠Public Endpoints (No Auth Required)

# Health check
curl http://localhost:3000/srv/status

# Site info
curl http://localhost:3000/site/basic-info

# List categories
curl http://localhost:3000/categories.json

# Latest topics
curl http://localhost:3000/latest.json

# Topic details
curl http://localhost:3000/t/{id}.json

# User profile
curl http://localhost:3000/u/{username}.json

# Search
curl 'http://localhost:3000/search?q={query}'

⁠Base URL

Once running, the API base URL is:

http://localhost:3000

All endpoints are relative to this base URL.

⁠What's Included

• Discourse: v2026.1.0 (stable release)
• PostgreSQL: 16.13
• Redis: 7.0.15
• Ruby: 3.2
• Node.js: 22.14.0

⁠Services

⁠First Setup

On first boot, complete the setup wizard at http://localhost:3000⁠

Default admin credentials (after setup):

• Email: [email protected]
• Password: readystack123

⁠Data Persistence

docker run -d \
  --name discourse \
  -p 3000:3000 \
  -v discourse_data:/data \
  -e DISCOURSE_HOSTNAME=localhost \
  readystack/discourse:v2026.1.0-CE-ubuntu24.04-r1

⁠Full API Documentation

See the complete API Integration Guide⁠ for:

• All 31 validated endpoints
• Request/response examples
• Authentication details
• Error handling

⁠Validation Report

This image has been validated with 46 automated tests:

• ✅ 31 tests passed
• ✅ 0 tests failed
• ⏭️ 15 skipped (require auth)
• ✅ 96.9% pass rate

See UC_VALIDATION_REPORT.md⁠ for details.

⁠Image Details

• Architecture: AMD64
• Base Image: Ubuntu 24.04 LTS
• Size: ~2.5 GB
• License: GPLv2 (Discourse)

⁠Security

• Runs as non-root discourse user
• Minimal attack surface (fat-container architecture)
• All services contained within single image

⁠Support

• Documentation: https://docs.discourse.org/⁠
• Community: https://meta.discourse.org/⁠
• ReadyStack: Contact your account representative

ReadyStack Chain ID: 206 | Validated: 2026-03-11