Prerequisites
Choose the server machine first
Agents and Git commands run on the Stib Server, not on the desktop client. Install the server on a machine that can reach the repositories you want to use.
For a local setup, run the server and desktop app on the same computer. For a team setup, run one reachable server and place or clone the repositories on that server.
Required
- A supported server platform: macOS on Apple Silicon, Windows x64/x86/ARM64, or Linux x64/ARM64.
- Git available to the server. The official Docker image already includes Git and OpenSSH.
- A readable and writable repository path for each project. Git is strongly recommended even though a non-Git directory can be used for limited workflows.
- Network access from the client to the server HTTP origin. The native release normally starts at
http://localhost:50505. - At least one configured agent credential or provider account before running an agent.
Desktop app
The current release targets:
| Platform | Architectures | Packages |
|---|---|---|
| macOS | Apple Silicon (ARM64) | .dmg, .pkg |
| Windows | x64, x86, ARM64 | .exe, .msi |
| Linux | x64, ARM64 | .deb, .rpm |
An AppImage is not currently published. Linux desktop systems also need the normal WebKit/GTK dependencies supplied by their distribution.
Optional capabilities
- Docker on the server for per-project agent sandboxes.
- An OIDC provider for SSO.
- A reverse proxy and TLS certificate for access outside a trusted local network.
- External services such as GitHub, Jira, Azure DevOps, or a custom OpenAPI integration.
Before the first agent run
Open Settings → Server → Credentials and add or verify the provider you want to use. Then open the project settings to confirm that the repository path is accessible. Stib shows capability and validation errors in these screens instead of assuming every provider CLI is installed.
Next: Quick Start.