Erugo Release Notes v0.2.0

A major release featuring self-registration, user management improvements, a new command palette, custom share URLs, a rebuilt upload engine powered by tusd, and much more.

User Management & Authentication

Self-Registration

Users can now register for accounts without requiring admin intervention. Self-registration can be enabled globally, and admins can choose whether to:

Allow any email domain to register
Restrict registration to specific email domains (comma-separated list)

New users who self-register receive an email verification code to confirm their email address before gaining access.

Forced Password Reset

Admins can now trigger a password reset for any user from the user management screen. When triggered:

The user receives a password reset email
They must create a new password before they can access the system again
Useful for security incidents or when manually onboarding users who need to set their own password

Improved Reverse Share Invites

The reverse share system has been overhauled. Inviting existing users to upload files now works correctly — they receive an email with a link that, when clicked after logging in, properly associates the upload invitation with their account.

Several bugs have been fixed that prevented invited users from being deleted amongst other issues.

Navigation & Usability

Command Palette

Press ⌘K (Mac) or Ctrl+K (Windows/Linux) to open the new command palette. Quickly search and navigate to any settings section, including:

All main navigation tabs (My Shares, System, Branding, Users, etc.)
Specific settings sections (SMTP, Authentication, Backups)
Sub-sections like Self Registration, Auth Providers, and Share URL Generation

The palette features fuzzy search, so you can type partial matches to find what you need quickly.

Deep Linking in Admin Panel

Settings sections now support deep linking via URL hashes. You can link directly to specific settings like:

#settings/system.auth.self_registration — Self registration settings
#settings/branding.logo-settings — Logo settings
#settings/system.backups — Backup management

This makes it easy to share links to specific settings or bookmark frequently used sections.

Sharing & Downloads

Custom Share URLs

Share URLs can now be generated using customisable patterns instead of the classic haiku style. Two modes are available:

Classic (Haiku): The original memorable word combinations, e.g., autumn-river-dawn-moon
Pattern: Define your own URL format using tokens:
- # for digits (0-9)
- A for uppercase letters (A-Z)
- a for lowercase letters (a-z)
- * for any alphanumeric character
- X for hexadecimal characters (0-9, A-F)
- [A-Z] for custom character ranges
- \# to escape and use literal characters

A live preview shows example URLs as you type your pattern, and preset templates (shortcode, UUID-style, etc.) are available to get you started quickly.

Admin Share Management

A new "All Shares" section in the admin panel allows administrators to:

View all shares across all users in the system
Filter shares by user
Toggle visibility of deleted shares
Manage download limits, expiry, and deletion for any share
See share ownership information alongside file details

Individual File Downloads

When viewing a multi-file share, users can now download individual files by clicking on them, rather than being forced to download the entire share as a ZIP. Files in nested directories are also individually downloadable.

Improved Download View

The download page has been redesigned with a cleaner layout showing:

Share name prominently displayed
Total size and file count statistics
Time remaining until expiry
Hierarchical file listing with folder structure
Optional message from the share creator

Upload System

New Upload Engine (tusd)

The upload system has been completely rebuilt using tusd, the official reference implementation of the tus resumable upload protocol. Benefits include:

Significantly faster upload speeds
More reliable handling of large files
Better memory efficiency
Support for resuming interrupted uploads

Interrupted Upload Detection

If your browser closes or loses connection during an upload, Erugo now detects this on your next visit and shows a notification about the interrupted upload. This helps you know that a previous upload didn't complete successfully.

Upload Session Timeout Fix

Fixed an issue where authentication would time out during very long uploads. Sessions are now automatically refreshed during the upload process, so they remain valid throughout the entire upload process regardless of duration.

Backup & Database

Backup Management

A new Backups section in System Settings allows administrators to:

Create backups on demand with a single click
View all backups with creation date and file size
Download backups for off-site storage
Delete old backups to free up space

Backups older than 7 days are automatically pruned to keep things tidy.

Safer SQLite Backups

The backup system now uses SQLite's VACUUM INTO command instead of file copying. This ensures:

Database consistency during backup
No risk of capturing a partially-written state
Smaller backup files (vacuuming removes fragmentation)

WAL Journal Mode

SQLite now uses Write-Ahead Logging (WAL) journal mode by default. This provides:

Better concurrent read/write performance
Improved reliability during crashes
Particularly beneficial for instances with multiple simultaneous users

Customisation

Custom Favicon

Administrators can now upload a custom favicon to replace the default Erugo icon. The favicon appears in browser tabs and bookmarks. You can:

Upload PNG, ICO, or SVG favicons
Preview the favicon before saving
Reset to the default Erugo icon at any time

Video Backgrounds

The background slideshow system now supports video files (MP4 and WebM) in addition to images. Videos:

Play automatically and loop seamlessly
Are muted by default
Integrate into the existing slideshow rotation with configurable timing

New "Erugo 2026" Theme

A fresh new default theme with updated colour variables and improved visual styling. The theme system now includes status colour variables for consistent UI feedback.

Statistics Dashboard

A new Stats section in the admin panel provides at-a-glance insights into your instance:

Storage Stats

Total disk usage with percentage bar
Space used by shares vs. available space
Visual warnings when storage is running low

Share Stats

Active, expired, and deleted share counts
Password-protected share count
Total files across all shares
Shares created in the last 7 days

Download Stats

Downloads over configurable time periods (7, 14, 30, 60, or 90 days)
All-time download count
Unique downloaders
Visual chart showing downloads by day
Top downloaded shares

User Stats

Total users, active users, admins, and guests
Users with shares
Top users by share count

Email & SMTP

Disable SSL/TLS for SMTP

SMTP configuration now includes an explicit "None" option for encryption, allowing connections to mail servers that don't support or require TLS/SSL. This is useful for:

Internal mail servers on trusted networks
Legacy mail systems
Development and testing environments

Email Template Improvements

Improved validation shows which required variables are missing
Visual indicators (✓/✗) for each variable's validity
Better error messages when saving incomplete templates
Templates only save if they have changes (dirty checking)

First-Run Setup Improvements

The initial setup wizard has been enhanced with a two-step process:

Create Admin Account: Set up your administrator email, name, and password
Optional Settings: Configure application name, URL, and upload a logo

The setup now pre-fills the application URL based on your current browser location, making configuration faster.

Other Improvements

tusd Service Status

A warning banner appears if the tusd upload service is unavailable, helping diagnose upload issues quickly.

Settings Cache Management

Settings are now cached more efficiently, with proper invalidation when changes are made.

Bug Fixes

Fixed issue where deleting users who had created share invites would fail
Fixed various edge cases in the reverse share invitation flow
Improved filename sanitisation in download responses
Fixed handling of very small files during upload
Better error handling and retry logic for share creation after uploads