Widefleet

Open-source, self-hosted platform for agent-built apps and workflows.

Build internal tools with your coding agent and keep the app code in your own project. Widefleet gives your team a shared place to deploy and use them, with company login, databases, file storage and controlled access to your systems.

Try it locally · Deploy your first app · Self-host · Documentation

The management workspace with synthetic example apps.

What you can do

• Build with your own tools. Start with SvelteKit by default or choose TanStack Start for React, edit the independent project with your coding agent and deploy through the CLI.
• Give colleagues access. Use company SSO, manage app access groups and make apps discoverable in the shared catalog.
• Keep app data together. Declare databases, file storage and key-value bindings. Runtime and storage.
• Control system access. Grant specific external destinations through network permissions and expose IT-managed services through app services.
• Run background work. Use Cron, Queues and durable Workflows, including retries and waits for events.
• Operate your apps. Publish previews, inspect deployment history, roll back code and query app logs from the CLI.

Try it locally

Use Linux x86-64, Docker Engine 29.8.1, Docker Compose 2.20.0 or newer, Bash, Git and an internet connection. Rootless Docker is supported. Keep ports 25450, 25452 and 25453 available. No local Node.js, pnpm, Rust, company identity provider or DNS setup is needed.

git clone https://github.com/widefleet/widefleet.git
cd widefleet
./dev up

1. Open http://localhost:25450, choose Sign in with Microsoft and select admin@example.test in the local identity provider.
2. Open Team Notes from management and sign in with the same account.
3. Add a note and a photo to try the app's database and private file storage.

On the first visit, accept the local self-signed certificate exception for https://auth.apps.localhost:25453 and https://team-notes.apps.localhost:25453. These hosts resolve to your machine; the demo does not install a system certificate.

./dev down # Stop the demo and keep its data; run ./dev up to resume

The demo uses synthetic identities and local-only credentials. See local development for rebuilding the example, inspecting logs and resetting demo data. For a company installation, follow self-hosting.

Deploy your first app

For an existing Widefleet installation, install the CLI, Node.js 22.18 or newer and pnpm 10.34.5 or newer. Create your app outside the platform checkout:

widefleet init my-app
cd my-app
pnpm install --frozen-lockfile
pnpm check
widefleet login
widefleet deploy

The CLI uses your company's configuration or asks for your work email or company domain. Approve the device code in your browser; the CLI remembers the installation. widefleet deploy builds locally, creates the app on its first deployment and prints its URL after activation. Later deployments update the same app.

Use pnpm dev to develop locally with your coding agent. Run widefleet preview to publish an isolated preview, then widefleet deploy when ready. See the app development guide for identity, data bindings and migrations.

How it works

flowchart LR
    Project["Your app project"] -->|"CLI: build and upload"| Management["Management UI and API"]
    Agent["Deployment agent"] -->|"Fetch deployment jobs"| Management
    Agent -->|"Install app versions"| Runtime["App runtime"]
    Team["Your team"] -->|"Company SSO"| Runtime
    Runtime --> Data["App databases and files"]
    Runtime --> Systems["Approved systems and app services"]

Loading

Management stores configuration and deployment jobs. The agent installs built code into a shared celld fleet, where apps and previews run as separate Dynamic Workers with their own resources. Published apps keep serving when management or the agent is stopped; the runtime, proxy, identity service and storage must remain available. See the architecture for the full deployment and authentication model.

Self-hosting and current support

The reference installation runs on one Linux x86-64 Docker host. You operate identity configuration, DNS, certificates, backups and upgrades. Follow the installation guide; use external services for external PostgreSQL, cloud storage and automatic HTTPS.

This README describes the current source branch. For an installation, select matching CLI, management and agent releases using each guide's version requirements. See releases and runtime updates.

Documentation

The documentation website is the home for app creators and installation operators. Repository documentation covers contributing to Widefleet itself:

Task	Guide
Build and deploy apps	CLI and app development, previews, migrations, Workflows
Control access and integrations	App access, network permissions, app services
Install and operate Widefleet	Operations, storage, upgrades and recovery
Inspect logs and reporting	App logs, installation reporting and opt-out
Understand the platform	Runtime, compatibility, API and uploads
Work on this repository	Contributor documentation, development and checks

Contributing and support

Use GitHub Issues for bugs, questions and feature requests. Include the relevant version and a minimal reproduction with synthetic data.

License

All Widefleet functionality is available under the MIT license, including the platform, CLI and app starter. Third-party components retain their own licenses and notices.