AstrBot DocsAstrBot Installation Guide: Where New Users Should Start
A community guide for first-time AstrBot users, helping you choose between desktop, launcher, Docker, and source-based setup paths before moving on to deployment or integration.
Who This Guide Is For
This guide is for first-time AstrBot users who need to choose a practical starting path without getting overloaded by implementation details.
Scope Boundary
This is a community orientation page, not a full official manual. Use this page to narrow your path, then continue with the official links at the end for exact commands and parameters.
Three Things To Decide Before You Install
- Are you trying AstrBot quickly, or planning for longer-running operation soon.
- Do you need a GUI-first experience, or a setup that is easier to automate later.
- Can you maintain the runtime environment after the first successful launch.
How To Choose Between Four Common Starting Paths
Desktop Client
Best for first contact and quick validation on a personal machine. Treat it as a trial path, not your final long-running architecture.
One-Click Launcher
Best for Windows users who want the shortest route to first success. Prioritize one stable run before any optimization.
Docker
Best for users who want repeatable environments and possible migration to server runtime later.
Source Deployment / CLI
Best for engineering users who need deeper control and are comfortable owning environment complexity.
The Community-Recommended Starting Order
- Pick one shortest viable path and target one successful local run.
- Keep notes about your environment and avoid switching paths too early.
- Validate one basic message round-trip before considering deployment changes.
- Move to Docker or CLI only when your target scenario requires it.
What Counts As a Successful Installation
You can mark installation as done when all three are true:
- AstrBot starts and can restart normally in the same environment.
- The management entry (for example WebUI) is reachable and basic settings persist.
- One basic message interaction succeeds without recurring runtime errors.
Where To Go Next
- Go to the Deployment Guide
- Optional: preview the Integration Guide
- Back to Docs Home
Continue With the Official Docs
AstrBot Docs
Overview of the AstrBot community docs, helping you choose the right next step across installation, deployment, integration, and post-setup actions.
AstrBot Deployment Guide: Choosing Between Local and Always-On Setup
A community guide to distinguish installation from deployment, local trial from always-on operation, and the practical trade-offs between Docker, panel-based setup, and longer-running hosting paths.