Install · v0.52.7

The factory on your machine.

The single-seat starter package is available on request. After that you request the Community license directly in the factory — or import a Professional or Enterprise license file.

In three steps

  1. Request the starter package

    Use the contact form (topic “Single-seat starter package”) or e-mail info@softwarefabrik.io. You receive the starter package as a ZIP.

  2. Unpack and start

    Create .env from the template, set the admin password, run ./start.sh (WSL, Linux, macOS) or .\start.ps1 (Windows) and open http://localhost:8080. Click by click in the quickstart.

  3. Get a license

    In the factory, under Einrichtung → Lizenz (setup → license), click “Community-Lizenz anfordern” (request Community license) and enter your e-mail address — no account. A Professional or Enterprise license file is imported on the same page.

What the starter package contains

  • the factory’s release JAR and the start scripts start.sh and start.ps1,
  • compose.yml for the database (PostgreSQL in a container) and the template .env.example,
  • installation helpers install-softwarefabrik.sh (WSL, Linux, macOS) and install-voraussetzungen.ps1 (Windows),
  • a short guide and guides for testing with your own project.

The full list is in the user manual, chapter installation.

Requirements

  • Java 25 and git,
  • Docker (Desktop or Engine) — only for the database,
  • for real runs the CLI of your AI agent, e.g. Claude Code, with a subscription or API key.

The installation helpers check these points and install what is missing after asking; the start scripts name what is still missing. For the first walkthrough with the free mock adapter you need neither an agent CLI nor a license.

License

The release JAR requires a license: without a license (or once grace and emergency grace have expired) no new run with a real AI agent starts; runs with the mock remain possible and the rest of the interface stays usable. You need not change anything for that: if you start a run from the interface without a valid license (quickstart, project page, “Neuer Lauf”, backlog), the factory announces before you click that it runs with the mock — the whole flow, but no real code — and the button reads “Mit dem Mock ausprobieren” (try with the mock). The Community license is free and renewed online; limits and durations of all tiers are on the pricing page.

The cost of the AI models is not included — you pay it through your own subscription or API key directly to the provider.

What’s next

  • Quickstart — from the unpacked starter package to your first run with the mock adapter.
  • Set up real runs — with a Claude subscription or an API key.
  • Demo — click through in the browser without installing.
  • Enterprise — self-hosted, air-gap and team operation.