Skip to content

chenasraf/nextcloud-forum

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

595 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Nextcloud Forum

GitHub Release Build NPM Lint PHP Frontend Tests PHPUnit MySQL PHPUnit PostgreSQL

A full-featured forum application for Nextcloud, allowing users to create discussion categories, threads, and posts within their Nextcloud instance.

Screenshot

Features

  • Category Management: Organize discussions with headers, categories, customizable colors, and drag-and-drop reordering
  • Threaded Discussions: Create and reply to organized discussion threads with pagination
  • BBCode Formatting: Rich text with built-in and custom BBCode tags, toolbar with overflow menu
  • File Attachments: Attach files from Nextcloud storage or upload via drag-and-drop
  • Notifications: Subscribe to threads, get notified on replies and @mentions
  • Reactions: React to posts with emoji reactions
  • Roles & Teams: Fine-grained permissions per role or Nextcloud Team, per category (view, post, reply, moderate)
  • Granular Management Permissions: Separate controls for dashboard, account management, roles, categories, and BBCodes
  • Guest Access: Optional public access for unauthenticated visitors with configurable permissions
  • Edit History: View post revision history with configurable visibility and per-account privacy controls
  • Read Markers: Track unread posts at thread and category level
  • Bookmarks: Save threads for quick access
  • Search: Advanced search with boolean operators and category filtering
  • Reusable Templates: Save and insert frequently used content snippets
  • Signatures: BBCode-formatted signatures on posts
  • Thread Drafts: Auto-saved drafts per category
  • User Profiles: Post history, statistics, and role badges
  • Dashboard Widgets: Recent activity, top threads, and top categories on the Nextcloud dashboard
  • Direct Post Links: Link directly to a specific post within a thread
  • Moderation Tools: Lock, pin, hide, and move threads; review and restore deleted content from the moderation page
  • Server Administration: Repair seeds, rebuild statistics, and assign roles from the Nextcloud admin panel
  • Modern UI: Built with Vue 3 and Nextcloud Vue components

Documentation

For detailed usage instructions, administration guides, and more, visit the Forum Wiki.

Installation

From the Nextcloud App Store

Install Forum directly from your Nextcloud instance through the Apps page.

Manual Installation

  1. Download the latest release from the releases page
  2. Extract to your Nextcloud apps directory:
cd /path/to/nextcloud/custom_apps
tar xfv forum-vX.X.X.tar.gz
  1. Enable the app from Nextcloud's Apps page or via command line:
php occ app:enable forum

Administration

For detailed administration guides, usage instructions, and more, visit the Administration Wiki.

OCC Commands

The Forum app provides several OCC commands for administration and maintenance, including commands for repairing installations, rebuilding statistics, and managing user roles.

For a complete list of available commands, usage examples, and detailed documentation, see the OCC Commands Wiki page.

Troubleshooting

Cannot access management features

If you are a Nextcloud administrator but cannot access Forum management features (e.g., managing categories, roles, or settings), this is likely due to missing database seeds or role assignments.

Option 1: Using OCC commands

Run the following commands from your Nextcloud installation directory:

# Repair database seeds (creates default roles and permissions if missing)
php occ forum:repair-seeds

# Assign administrator role to an account
php occ forum:set-role <username> admin

Option 2: Using the server administration panel

  1. Log in to Nextcloud as an administrator
  2. Go to Administration Settings (click your profile picture → Administration Settings)
  3. Navigate to Forum in the left sidebar under the Administration section
  4. Use the Repair Seeds button to restore default roles and permissions
  5. If the seeds are already in place, use the Assign Roles section to assign the administrator role to accounts

Contributing

I am developing this app on my free time, so any support, whether code, issues, or just stars is very helpful to sustaining its life. If you are feeling incredibly generous and would like to donate just a small amount to help sustain this project, I would be very very thankful!

Buy Me a Coffee at ko-fi.com

I welcome any issues or pull requests on GitHub. If you find a bug, or would like a new feature, don't hesitate to open an appropriate issue and I will do my best to reply promptly.

Translations

If you're interested in translating this app, please visit the Forum app resource on Transifex.

For more information about translations, including how to join the Nextcloud project, see Translate Nextcloud.

Translation resources are synced daily and updates are available on the next release of the app after they are synced.

Development

For detailed development guides and documentation, visit the Development Wiki.

License

This app is licensed under the AGPL-3.0-or-later license.