Zum Hauptinhalt springen
Standardmäßig lauscht Lemonade Server auf http://127.0.0.1:13305/v1 — er ist von einem anderen Rechner nicht erreichbar, außer Sie binden ihn breiter oder leiten den Port weiter. Lemonade Server bringt keine eingebaute Authentifizierung für den Fernzugriff mit. Lassen Sie ihn auf localhost und betreiben Sie den Tokios-Connector daneben: Der Connector wählt sich ausgehend zu https://api.tokios.com ein, und Ihre Tools, Teammitglieder oder Agenten rufen einen authentifizierten Endpunkt von überall auf.
Zuletzt überprüft: 2026-10-14. Lemonade Server wird aktiv weiterentwickelt — prüfen Sie lemonade-server.ai für die neueste Version.
AMD NPU-Unterstützung. Lemonade Server ist der einzige lokale LLM-Server, der Inferenz auf AMD Ryzen AI NPUs beschleunigt (Ryzen AI 300/400 Serie). Er erkennt auch automatisch Vulkan-, ROCm-, CUDA- und Metal-Backends, sodass er über AMD-, NVIDIA- und Apple Silicon-Hardware ohne manuelle Konfiguration funktioniert.

Was ist Lemonade Server

Lemonade Server ist ein Open-Source-lokaler LLM-Server, der von AMD unterstützt wird. Er bietet eine OpenAI-kompatible API unter http://localhost:13305/v1 und unterstützt mehrere Modellformate (GGUF, ONNX, FLM) über mehrere Backends:
  • AMD Ryzen 7000/8000/200 Serie — GPU-Beschleunigung über Vulkan (llama.cpp-Backend)
  • AMD Ryzen AI MAX+ (Strix Halo) — ROCm mit vLLM oder llama.cpp
  • AMD Ryzen AI 300/400 Serie — NPU-Beschleunigung über ONNX Runtime GenAI (hybride NPU+iGPU-Ausführung)
  • NVIDIA GPUs — CUDA-Beschleunigung
  • Apple Silicon — Metal-Backend
Lemonade Server erkennt automatisch Ihre Hardware und wählt das beste Backend. Sie können das Backend bei Bedarf auch manuell überschreiben.
Lemonade Server an alle Schnittstellen zu binden (0.0.0.0) macht ihn von Ihrem Netzwerk aus erreichbar, aber Lemonade Server bringt keine eingebaute Authentifizierung für entfernte Aufrufer mit — jeder, der Port 13305 erreichen kann, kann die API aufrufen. Wenn Ihr ISP CGNAT verwendet, haben Sie ohnehin keine stabile öffentliche IP, an die Sie weiterleiten könnten. Tokios fügt Bereichs-sk-tok-… API-Schlüssel hinzu, ohne einen eingehenden Port zu öffnen.
Tailscale löst persönlichen Zugriff gut — Ihre eigenen Geräte treten einem privaten Mesh-Netzwerk bei und können sich sicher gegenseitig erreichen. Der Haken ist bei allem über persönliche Nutzung hinaus: Teammitglieder oder SaaS-Clients, die Ihr Modell aufrufen müssen, müssen zuerst Ihrem Tailnet beitreten, was nicht zu einem öffentlichen API-Schlüssel-Modell passt. Cloudflare Tunnel leitet Traffic über Cloudflares Edge ohne erforderlichen eingehenden Port weiter, aber standardmäßig puffert Cloudflare Antworten, anstatt sie zu streamen, es sei denn, die Antwort trägt einen text/event-stream Content-Type-Header, und proxied Anfragen unterliegen Cloudflares Proxy-Timeouts (ungefähr 100 Sekunden im kostenlosen Tarif) — lange Generierungen können mitten im Stream abgeschnitten werden.
Das ist keine Kritik an diesen Tools — sie lösen ein anderes Problem (Geräte-Mesh-Netzwerke, Edge-Proxying). Tokios ist speziell für eine Sache gebaut: einen lokalen Modell-Endpunkt in eine authentifizierte API zu verwandeln, die Sie von überall aufrufen können.

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie haben:
  • Lemonade Server installiert — siehe Wie Lemonade Server installieren unten
  • Ein Modell heruntergeladen — verwenden Sie lemonade pull <model> um ein Modell herunterzuladen
  • Tokios-Connector — Sie installieren ihn während der Einrichtung

Wie Lemonade Server installieren

Lemonade Server bietet Installer für Windows, Linux, macOS und Docker. Ab v10.1 ist der CLI-Befehl lemonade (die alte lemonade-server-CLI ist veraltet).
Überprüfen Sie nach der Installation, dass Lemonade Server läuft:
Sie sollten den Serverstatus und das erkannte Backend sehen (Vulkan, ROCm, CUDA, Metal oder NPU).

Wie ein Modell mit Lemonade Server bereitstellen

Laden Sie ein Modell herunter und stellen Sie es mit 2 Befehlen bereit:
Lemonade Server erkennt automatisch Ihre Hardware und wählt das beste Backend. Das Modell wird jetzt unter http://localhost:13305/v1 bereitgestellt.
NPU-Beschleunigung auf AMD Ryzen AI. Wenn Sie einen AMD Ryzen AI 300/400 Serie-Prozessor haben, kann Lemonade Server die NPU für Inferenz verwenden. Laden Sie ein für die NPU optimiertes ONNX-Modell:
NPU-Modelle verwenden hybride NPU+iGPU-Ausführung und werden am -NPU-Suffix erkannt.

Häufige Lemonade Server CLI-Befehle

Der rein ausgehende Weg

1

Lassen Sie Lemonade Server lokal wie gewohnt laufen

Behalten Sie Lemonade Server auf 127.0.0.1 — binden Sie ihn nicht breiter als Loopback. Laden Sie Ihr Modell und stellen Sie es bereit:
Lassen Sie ihn auf dem Standard http://127.0.0.1:13305 lauschen.
2

Paaren Sie den Tokios-Connector

Melden Sie sich bei tokios.com/console an, öffnen Sie den Tab Setup und klicken Sie auf Start pairing. Tokios zeigt einen einmaligen Pairing-Code wie TKS-XXXX-XXXX an, der etwa 15 Minuten gültig ist.Führen Sie auf dem Rechner, auf dem Lemonade Server läuft, den Install-Einzeiler für Ihr Betriebssystem aus:
Windows
macOS
Linux
Haben Sie tokios-connector bereits installiert? Übergeben Sie den Code direkt stattdessen:
Zurück in der Konsole, approve das Gerät auf dem Reiter Setup oder Connectors. Das Token des Connectors wird über den Tunnel geliefert, sobald er genehmigt ist — Sie sehen es nie auf dem Bildschirm oder fügen es in eine Datei ein.
3

Richten Sie den Connector auf Lemonade Servers /v1 API

Lemonade Server bietet eine OpenAI-kompatible Oberfläche unter /v1, und das ist es, womit Tokios spricht. Für den grundlegenden Single-Modell-Pfad verwendet der Setup-Assistent der Konsole automatisch http://127.0.0.1:13305/v1 als Upstream. Wenn Sie mehrere Modelle über eine tokios-connector.json-Konfiguration bereitstellen, setzen Sie die Upstream-BaseUrl explizit:
Siehe Connector-Konfiguration für das vollständige Multi-Modell-Dateiformat.
4

Registrieren Sie ein Deployment

Im Tab Models registrieren Sie das Lemonade Server-Modell und wählen einen öffentlichen Namen — zum Beispiel qwen3-tunnel. Dieser öffentliche Name, nicht Lemonades lokale Modell-ID, ist es, was Clients im model-Feld senden.
5

Erstellen Sie einen API-Schlüssel

Im Tab Keys klicken Sie auf Create key. Optional können Sie ihn mit Modellnamen-Mustern auf bestimmte Deployments einschränken (kommagetrennte Globs, * für alle). Kopieren Sie den sk-tok-…-Schlüssel jetzt — er wird nur einmal angezeigt.

Von überall aus nutzen

Sobald Sie einen Deployment-Namen und einen API-Schlüssel haben, kann jeder OpenAI- oder Anthropic-kompatible Client Ihr Lemonade Server-Modell erreichen — von einem anderen Rechner, dem Laptop eines Teammitglieds oder einem gehosteten Agenten.
Das model-Feld ist immer Ihr registrierter Deployment-Name (qwen3-tunnel oben), niemals Lemonades lokale Modell-ID. Siehe Claude Code verwenden für das Persistieren der Umgebungsvariablen über Sitzungen hinweg.

Was ist AMD NPU-Unterstützung

AMD Ryzen AI 300/400 Serie-Prozessoren enthalten eine dedizierte Neural Processing Unit (NPU) für KI-Workloads. Lemonade Server ist der einzige lokale LLM-Server, der Inferenz auf der AMD NPU mit hybrider NPU+iGPU-Ausführung beschleunigt.

Wie NPU-Beschleunigung funktioniert

  • Modellformat: NPU-optimierte Modelle verwenden das ONNX-Format (am -NPU-Suffix erkannt, z.B. Llama-3.2-1B-Instruct-NPU)
  • Ausführung: Lemonade Server teilt die Inferenz zwischen NPU und iGPU mit OnnxRuntime GenAI auf
  • Backend: Das NPU-Backend ist automatisch — Lemonade Server erkennt Ihren Ryzen AI-Prozessor und wählt die NPU-Ausführung, wenn Sie ein NPU-optimiertes Modell ausführen
  • Leistung: NPU-Beschleunigung lagert Arbeit von CPU und GPU aus, reduziert den Stromverbrauch und gibt Ressourcen für andere Aufgaben frei

Welche AMD-Prozessoren NPU-Inferenz unterstützen

NPU-Unterstützung erfordert AMD Ryzen AI Software-Treiber. Lemonade Server bündelt die erforderliche Laufzeitumgebung, aber stellen Sie sicher, dass Ihr System die neuesten AMD Adrenalin-Treiber installiert hat.

Lemonade Server im Vergleich zu anderen Backends

Lemonade Server ist eines von mehreren Backends, die Tokios unterstützt. So vergleicht es sich:
Lemonade Server ist eine gute Wahl, wenn Sie AMD-Hardware haben (insbesondere Ryzen AI mit NPU) oder einen plattformübergreifenden Server wollen, der Ihr Backend automatisch erkennt. Wenn Sie einfach nur den schnellsten Start auf beliebiger Hardware wollen, ist Ollama immer noch am einfachsten.

FAQ

Lemonade Server lauscht standardmäßig auf Port 13305, gebunden an 127.0.0.1 (nur localhost). Die OpenAI-kompatible API ist unter http://localhost:13305/v1. Sie können mit lemonade status oder curl http://localhost:13305/v1/models überprüfen, ob Lemonade Server läuft.
Führen Sie lemonade status aus, um das erkannte Backend zu sehen (Vulkan, ROCm, CUDA, Metal oder NPU). Lemonade Server erkennt automatisch Ihre Hardware und wählt das beste Backend. Sie können auch lemonade status --json für maschinenlesbare Ausgabe verwenden.
Ja. Lemonade Server ist der einzige lokale LLM-Server, der Inferenz auf AMD Ryzen AI 300/400 Serie NPUs beschleunigt. Laden Sie ein NPU-optimiertes Modell mit lemonade pull <model>-NPU und führen Sie es mit lemonade run <model>-NPU aus. Das NPU-Backend verwendet hybride NPU+iGPU-Ausführung über OnnxRuntime GenAI.
Ja. Lemonade Server erkennt NVIDIA GPUs automatisch und verwendet das CUDA-Backend. Er funktioniert auf jeder Hardware, die Vulkan, ROCm, CUDA oder Metal unterstützt — AMD, NVIDIA und Apple Silicon werden alle unterstützt.
Stellen Sie Lemonade Server nicht direkt bereit — verwenden Sie stattdessen Tokios. Tokios fügt authentifizierten Fernzugriff hinzu, ohne einen eingehenden Port zu öffnen. Siehe die Einrichtungsschritte oben für die vollständige Anleitung.
Ja. Setzen Sie "stream": true und Tokios gibt Standard Server-Sent Events (SSE) im OpenAI- oder Anthropic-Format zurück, je nachdem, welche API-Oberfläche Sie aufgerufen haben.
Ja. Erstellen Sie einen separaten sk-tok-… Schlüssel pro Teammitglied im Tab Keys und beschränken Sie jeden Schlüssel auf nur die Deployments, die sie brauchen. Das Widerrufen eines Schlüssels stoppt die Authentifizierung sofort, sodass Sie den Zugriff abschneiden können, ohne Lemonade Server oder den Connector anzufassen.
Ja. Registrieren Sie zusätzliche Deployments im Tab Models oder verwenden Sie eine tokios-connector.json-Konfigurationsdatei, um mehrere Upstreams und Routen für einen einzelnen Connector zu definieren. Siehe Connector-Konfiguration.
Führen Sie unter Linux sudo apt update && sudo apt upgrade lemonade-server (APT) oder sudo snap refresh lemonade-server (Snap) aus. Laden Sie unter Windows den neuesten MSI-Installer von der Releases-Seite herunter.
Die NPU unterstützt spezifische Modellarchitekturen, die für die ONNX-Ausführung optimiert sind. Führen Sie lemonade list aus, um verfügbare NPU-Modelle zu sehen (am -NPU-Suffix erkannt). Nicht alle Modelle sind NPU-kompatibel — GGUF-Modelle laufen stattdessen auf dem GPU/CPU-Backend. Siehe die Lemonade FAQ für die vollständige Liste der NPU-unterstützten Architekturen.

Ihr Modell verlässt nie Ihren Rechner — Ihr Endpunkt funktioniert überall

Lemonade Server macht weiterhin genau das, was er heute tut, auf localhost, ohne eingehende Ports und ohne freigelegte API. Der Connector wählt sich nur ausgehend ein. Alles darüber hinaus — Auth, Routing, Streaming — ist ein Endpunkt, den Sie von jedem Rechner, Teammitglied oder Agenten aufrufen können, dem Sie einen Schlüssel geben.

Schnellstart

Paaren Sie einen Connector und registrieren Sie Ihr erstes Modell von Anfang bis Ende.

API-Schlüssel

Erstellen, einschränken und rotieren Sie sk-tok-… Schlüssel für Teammitglieder und Agenten.

Strix Halo-Einrichtung

Verwandeln Sie Ihre AMD Strix Halo-Kiste mit Lemonade Server in einen Modell-Endpunkt.

Unterstützte Backends

Sehen Sie alle Backends, die Tokios unterstützt — Ollama, llama.cpp, vLLM, LM Studio und mehr.

Quellen