We're thrilled to announce the release of Erugo v0.0.010, an exciting update to our self-hosted file-sharing platform that introduces provisional external authentication provider support. This highly requested feature allows administrators to begin configuring multiple OAuth and OpenID Connect providers, giving your existing users more flexible login options while maintaining the security you expect from Erugo.

Enhanced Login Experience for Existing Users

The most visible change in this release is our redesigned login screen, which now elegantly displays your configured authentication providers alongside the traditional email/password option. Existing users whose email addresses match between Erugo and the external provider can choose their preferred login method with a single click, streamlining the authentication process while maintaining security.

New login screen with external auth provider support

Initial Authentication Provider Options

Erugo v0.0.010 ships with built-in support for several popular authentication providers:

  • Google: Allow existing users to sign in with their Google accounts
  • Microsoft: Enable Microsoft 365 and Azure AD authentication
  • Authentik: Integrate with your self-hosted Authentik identity management
  • Generic OpenID Connect: Connect to any standard OIDC-compliant provider

This initial implementation is a first step toward integrating Erugo with your existing identity infrastructure. Note that this release supports authentication for existing users only (where email addresses match), with account linking and new user registration via external providers planned for future releases.

Simple Administration

We've designed the authentication system to be easy to configure through an intuitive administration interface. Administrators can:

  • Add, edit, and remove authentication providers
  • Enable or disable providers individually
  • Configure provider-specific parameters
  • View callback URLs for external provider setup

The enhanced settings interface makes managing authentication straightforward, with improved form validation and error handling to ensure proper setup.

Settings interface for authentication configuration

Getting Started with External Authentication

Configuring external authentication providers in Erugo v0.0.010 is simple:

  1. Navigate to Settings > System > Auth
  2. Click the "+" button to add a new provider
  3. Select the provider type and fill in the required fields
  4. Copy the provided callback URL to configure in your external provider
  5. Enable the provider once configuration is complete

This straightforward process allows you to quickly set up and test your authentication integration.

Upgrading to v0.0.010

As with all Erugo updates, upgrading is simple. If you're using Docker, pull the latest image:

docker pull wardy784/erugo:latest

Then restart your containers:

docker compose down
docker compose up -d

Current Limitations and Community Support

Important notes about the current implementation:

  • External authentication works only for existing Erugo users
  • The user's email address must match between Erugo and the external provider
  • New user registration via external providers is not yet supported
  • Account linking between multiple providers is planned for future releases

Join our Discord community to discuss this release, share your feedback, or get help with configuring authentication providers. We're particularly interested in hearing about your experiences with this provisional feature as we continue to refine it.

What's Next?

We're continuously working to improve Erugo based on community feedback. This provisional external authentication support is just the beginning, with several enhancements already planned:

  • Account linking: Allow users to connect their Erugo account with multiple external providers
  • New user registration: Enable new users to register directly using external authentication
  • Profile synchronization: Maintain consistent user details between systems
  • Enhanced error handling: Improved user experience when authentication issues occur

Stay tuned for announcements about these developments in upcoming releases!

Erugo remains committed to providing a secure, user-friendly file-sharing solution that gives you complete control over your data. We thank our growing community for your continued support and feedback.