diff --git a/backend/src/plugins/swagger.ts b/backend/src/plugins/swagger.ts
index b529ea8..c511a8d 100644
--- a/backend/src/plugins/swagger.ts
+++ b/backend/src/plugins/swagger.ts
@@ -5,26 +5,33 @@ import swaggerUi from "@fastify/swagger-ui";
 
 export default fp(async (server: FastifyInstance) => {
     await server.register(swagger, {
-        mode: "dynamic", // wichtig: generiert echtes OpenAPI JSON
+        mode: "dynamic",
         openapi: {
             info: {
-                title: "Multi-Tenant API",
-                description: "API Dokumentation für dein Backend",
+                title: "FEDEO Backend API",
+                description: "OpenAPI specification for the FEDEO backend",
                 version: "1.0.0",
             },
-            servers: [{ url: "http://localhost:3000" }],
+            servers: [{ url: "/" }],
+            components: {
+                securitySchemes: {
+                    bearerAuth: {
+                        type: "http",
+                        scheme: "bearer",
+                        bearerFormat: "JWT"
+                    }
+                }
+            }
         },
     });
 
     // @ts-ignore
     await server.register(swaggerUi, {
-        routePrefix: "/docs", // UI erreichbar unter http://localhost:3000/docs
-        swagger: {
-            info: {
-                title: "Multi-Tenant API",
-                version: "1.0.0",
-            },
-        },
-        exposeRoute: true,
+        routePrefix: "/docs",
     });
-});
\ No newline at end of file
+
+    // Stable raw spec path
+    server.get("/openapi.json", async (_req, reply) => {
+        return reply.send(server.swagger());
+    });
+});