Release Notes: Ollama Proxy Fortress v9.0.0

This is a stability and security-focused release that addresses a critical startup bug and hardens the application based on a comprehensive security audit.

🌟 Highlights

• 🚀 Hyper-Detailed Live Dashboard: Go beyond ollama ps. Get a real-time, auto-updating view of your proxy's health (CPU, Memory, Disk), see all active models across all servers, monitor the live health of your load balancer, and watch API rate-limit queues fill and reset in real-time.

• 🎨 Radical Theming Engine: Why should your tools be boring? Choose from over a dozen stunning UI themes to match your personal aesthetic. Whether you prefer a sleek Material Design, a futuristic Cyberpunk neon glow, a retro CRT Terminal, or a stark Brutalist look, you can make the interface truly yours.

• 📈 Comprehensive Analytics Suite: Don't just guess your usage—know it. Dive into beautiful, interactive charts for daily and hourly requests, model popularity, and server load. Plus, with a single click, drill down into per-user analytics to understand individual usage patterns. All data is exportable.

• 👤 Granular User & API Key Management: Effortlessly create and manage users. The sortable user table gives you at-a-glance stats on key counts, total requests, and last activity. From there, manage individual API keys with per-key rate limits, and temporarily disable or re-enable keys on the fly.

• 🌐 Multi-Server Management & Federation: Centrally manage all your Ollama backend servers. The proxy load-balances requests and provides a unified, federated view of all available models from all your instances combined.

• ✨ Polished User Experience: From a streamlined logo upload process to a rich, navigable Help page with a scroll-spying table of contents, every detail has been crafted to be intuitive and enjoyable to use.

• 🚀 Effortless 1-Click Setup: No Docker, no pip install, no command-line wizardry required. Just download and run a single script.

• 🛡️ Comprehensive Security Audit: The entire codebase was audited for common security vulnerabilities. The application was found to be well-protected against major threats like SQL Injection, XSS, and CSRF.

• 🐛 Critical Startup Bug Fix: Resolves a 500 Internal Server Error that occurred for some users immediately after starting the server, making the dashboard inaccessible.

• 🔒 Minor Information Leak Patched: An error-handling vulnerability on the Settings page has been fixed to prevent leaking potentially sensitive server information.

Detailed Changes

🛡️ Security Enhancements

As part of our commitment to security, a full code audit was performed.

• Conclusion: The application shows no signs of malware and correctly implements modern security practices. It is not vulnerable to common critical attacks.
• Vulnerability Patched: A minor information leak was identified and resolved.
  • Previous Behavior: If saving the application settings failed due to an unexpected server error, the raw exception message could be displayed to the admin user.
  • New Behavior: A generic, user-friendly error message is now displayed, while the full technical details are logged to the server console for debugging. This prevents leaking internal server state or configuration details.

🐛 Bug Fixes

• Fixed NoMatchFound on Startup:
  • Symptom: The application would start successfully but immediately throw a 500 Internal Server Error when navigating to /admin/dashboard. The logs showed a starlette.routing.NoMatchFound: No route exists for name "admin_settings".
  • Resolution: This was caused by an internal route naming conflict. The route for the settings page has been renamed, which completely resolves the issue and ensures the dashboard loads correctly after a fresh installation.

How to Upgrade

If you are running the application from the source code, please follow these steps:

1. Stop the currently running server (press Ctrl+C in the terminal).
2. Update the files with the changes provided in the previous step. If you are using Git, you can pull the latest changes.
3. Restart the application using your run.sh or run_windows.bat script.

No database migrations are necessary for this update.

We are confident that this version provides a more stable and secure experience for all users. Thank you for your support, and please report any further issues on our GitHub page.

We are thrilled to announce the landmark release of Ollama Proxy Fortress v9.0: The Control Tower Update!

This is more than just an update; it's a complete transformation of the application from a simple security gateway into a professional-grade management and analytics platform. This release introduces unprecedented control over your API keys, powerful data visualization tools, and a dramatically simplified and robust installation process.

Thank you to our community for the rigorous testing and invaluable feedback that made this rock-solid release possible.

✨ What's New?

📊 Introducing the Analytics Dashboard!

The "Usage Stats" page has been completely revamped into a powerful analytics dashboard. You can now visualize your proxy's activity with three interactive charts:

• Requests per Day: A line chart showing usage trends over the last 30 days.
• Peak Hours: A bar chart identifying the busiest hours of the day (in UTC).
• Server Load Distribution: A doughnut chart showing how requests are distributed across your backend Ollama servers.
• Export Everything: Every chart and table can be exported as a PNG image or CSV data file, perfect for reports and analysis.

🔑 Advanced API Key Controls: Rate Limits & Disable/Enable

You now have fine-grained power over every API key:

• Per-Key Rate Limiting: When creating a new key, you can now set a custom rate limit (e.g., 100 requests every 5 minutes) that overrides the global server settings. Leave it blank to use the default.
• Disable/Enable Keys: Instead of just revoking a key, you can now temporarily disable it. A disabled key is blocked from making API calls but can be re-enabled at any time. This is perfect for temporarily pausing an application's access without deleting its key.

⚙️ Dramatically Simplified and Robust Installation

• Alembic Has Been Removed! We have completely removed the Alembic database migration system. The application now creates and manages its own database schema automatically on startup. This eliminates an entire class of SQLite-related errors and makes the installation process faster and far more reliable.
• Intelligent Setup Scripts: The run.sh and run_windows.bat scripts are now smarter, with resumable installations, a Python-powered setup wizard for Windows, and safety checks for missing configuration files.
• Linux Systemd Service: The run.sh script now offers to automatically create and enable a systemd service for you, allowing the proxy to run on boot as a background process.

UX Improvements

• New Help & Credits Page: A dedicated in-app page provides quick-start guides, code examples for cURL, Python requests, and lollms-client, and gives credit to the open-source projects that make this possible.
• Clearer UI Hints: The API key creation form now includes placeholder examples and descriptive text to make the rate limit feature easy to understand.
• Polished Documentation: The main README.md has been updated with new badges, screenshots, and documentation for all the new features.

🛠️ Critical Bug Fixes

This release also includes crucial fixes for stability and correctness:

• API Key Parsing: Fixed a critical bug where API keys containing underscores in their random segment would fail validation. Key generation now uses a guaranteed safe character set.
• Proxy Forwarding: Corrected the proxy logic to ensure the /api/ prefix is correctly handled, fixing issues where requests to endpoints like /api/tags would fail.
• SQLAlchemy Sessions: Resolved multiple MissingGreenlet errors by correctly managing object state across asynchronous database sessions, particularly on the key creation page.

⬆️ Upgrading from a Previous Version

IMPORTANT: Due to the removal of the Alembic migration system and significant database schema changes, a direct upgrade is not supported. The only way to upgrade is to perform a fresh installation.

1. (Optional) Back up your existing .env file if you wish to reference your old settings.
2. Run the reset.sh or reset.bat script to completely clean your project directory.
3. Pull the latest code from the repository (git pull origin main).
4. Run the installer script (run.sh or run_windows.bat) to perform a fresh, clean installation.

We believe this release makes Ollama Proxy Fortress the most powerful, secure, and user-friendly management tool for any Ollama user. Head over to the Releases page to download it now

This is the last stable version before a full revamping of the project to provide a more configurable and user friendly interface.