"Works of art make rules; rules do not make works of art."
— Claude Debussy
1Backend is a full-stack platform for the AI era. It lets you build distributed applications fast, without early infrastructure overhead. It’s a framework, proxy, and runtime that handles auth, user accounts, microservice and microfrontend routing, email, and more.
It can run and program LLMs inside containers. Zero-trust, zero-config, with its own ORM for development even without a database.
It’s multitenant—host multiple apps or sites on one install. In essence, a distributed operating system for your applications.
Easiest way to run 1Backend is with Docker. Install Docker if you don't have it. Step into repo root and:
docker compose up
Also see this page for other ways to launch 1Backend.
Check out the examples folder or the relevant documentation to learn how to easily build testable, scalable microservices on 1Backend.
Here are the conceptual steps though to illustrate how simple is a 1Backend service:
Each service - just like humans - must have their account and manage their own credentials. Just like humans, they must remember their passwords :)).
See the Register and Login endpoints.
import (
"github.com/1backend/1backend/sdk/go/boot"
"github.com/1backend/1backend/sdk/go/client"
)
oneBackendClient := client.NewApiClientFactory(service.Options.ServerUrl).Client()
token, err := boot.RegisterServiceAccount(
oneBackendClient .UserSvcAPI,
"your-svc", // Account slug
"Your Service", // Display name
credentialStore, // This is just a DB handle
)
Call the RegisterInstance
endpoint directly from any programming language.
import (
"github.com/1backend/1backend/sdk/go/client"
)
oneBackendClient := client.NewApiClientFactory(service.Options.ServerUrl).Client()
oneBackendClient.RegistrySvcAPI.
RegisterInstance(context.Background()).
Body(openapi.RegistrySvcRegisterInstanceRequest{
Url: "https://your-service-url",
}).Execute()
All services registered will be available under their slug:
curl http://127.0.0.1:11337/your-svc/your-endpoint`.
1Backend doesn't just manage microservices, it also manages microfrontends. You can deploy a React/Vue/Angular/etc. apps as microfrontends and 1Backend will route requests to them based on routes:
oo route save --id=yourdomain.com --target=http://your-network-local-frontend-url
Automatic SSL is supported out of the box, see the Proxy Svc documentation and the edge proxy mode.
Install oo
to get started (at the moment you need Go to install it):
go install github.com/1backend/1backend/cli/oo@latest
$ oo env ls
ENV NAME SELECTED URL DESCRIPTION REACHABLE
local * http://127.0.0.1:11337 true
$ oo login 1backend changeme
$ oo whoami
slug: 1backend
id: usr_e9WSQYiJc9
app:
id: app_hRKWXZzK6P
host: unnamed
roles:
- user-svc:user
- user-svc:admin
See the Running the daemon page to help you get started.
For articles about the built-in services see the Built-in services page. For comprehensive API docs see the 1Backend API page.
We have temporarily discontinued the distribution of the desktop version. Please refer to this page for alternative methods to run the software.
1Backend is licensed under AGPL-3.0.