Nextcloud OAuth Setup

Prev Next

Nextcloud is an open-source storage, collaboration, and communication platform. You can let users sign in to your Rocket.Chat workspace with their Nextcloud credentials. This keeps control of data within your environment while adding secure authentication.

Prerequisites

Before setting up Nextcloud OAuth, you need:

  • Administrator access to your  Nextcloud server

  • A Nextcloud OAuth app

  • The app’s Client ID and Client Secret

  • The ability to add Rocket.Chat’s callback URL to your Nextcloud app settings

When you create the app in Nextcloud, add the Nextcloud Callback URL from Rocket.Chat to the app configuration.

Configure Nextcloud OAuth

After you have your Nextcloud app credentials:

  1. In Rocket.Chat, go to Manage > Workspace > Settings > OAuth.

  2. Expand the Nextcloud section.

  3. Turn OAuth Enabled on.

  4. Enter the following values:

    • Nextcloud Server URL: The base URL of your Nextcloud instance

    • Nextcloud ID: The Client ID from your Nextcloud app

    • Client Secret: The Client Secret from your Nextcloud app

    • Nextcloud Callback URL: Copy this value from Rocket.Chat and add it to your Nextcloud app settings

  5. Optional: Customize the sign-in button.

    • Button Text: The label shown on the sign-in button

    • Button Text Color: The text color

    • Button Color: The button background color

  6. Select Save changes.

After you save, the Sign in with Nextcloud button appears on the workspace sign-in page. Users can then sign in with their Nextcloud accounts.

Accessibility Note

Changing button colors may result in non-compliance with WCAG (Web Content Accessibility Guidelines) requirements. Make sure your chosen colors meet recommended contrast and readability standards to ensure accessibility for all users.