winget install --id=sysmanage.sysmanage -e SysManage is the server-side component of an open-source fleet management platform. It accepts inventory from SysManage Agent hosts, dispatches declarative deployment plans (package install, firewall config, antivirus deployment, VM lifecycle), surfaces health and compliance dashboards, and exposes a REST + WebSocket API for orchestration.
A modern, cross-platform system monitoring and management platform with real-time WebSocket communication, built with FastAPI and React.
Complete documentation is available at sysmanage.org
SysManage is a comprehensive system management solution that allows you to monitor and manage remote servers across multiple operating systems (Linux, Windows, macOS, FreeBSD, and OpenBSD). The system consists of:
> 🔐 Security Note: After installation, you MUST run the scripts/sysmanage_secure_installation script to create the initial admin user and configure unique security tokens for your installation.
📖 For detailed platform-specific installation instructions, visit sysmanage.org/docs/server/installation.html
# 1. Clone and setup
git clone https://github.com/bceverly/sysmanage.git
cd sysmanage
# 2. Create virtual environment
python3.12 -m venv .venv # any of Python 3.10–3.14
source .venv/bin/activate
# Note: On BSD systems (FreeBSD, OpenBSD, NetBSD), use: . .venv/bin/activate
# 3. Setup database (see documentation for detailed instructions)
# Install PostgreSQL and SQLite3 (required before installing Python dependencies)
# FreeBSD users also need: sudo pkg install py311-sqlite3
# Create PostgreSQL database and user
# Configure /etc/sysmanage.yaml
# 4. Install dependencies
# Note: Rust is required for some Python dependencies
# Install Rust: https://rustup.rs/ or use your package manager
# FreeBSD users also need: sudo pkg install jpeg-turbo tiff freetype2 png webp lcms2
pip install --upgrade pip
pip install -r requirements.txt
# 5. Run migrations
alembic upgrade head
# 6. Install frontend dependencies
cd frontend && npm install && cd ..
# 7. Run secure installation script (REQUIRED for new installations)
scripts/sysmanage_secure_installation
# This script creates the initial admin user and sets unique security tokens
# 8. Start the application
make start
# Run all tests
make test
# Backend tests only
python -m pytest tests/ -v
# Frontend tests only
cd frontend && npm test
# End-to-End tests (optional - requires Playwright)
# Note: Playwright may not be available on all platforms (e.g., OpenBSD)
npm run test:e2e
# Linting
make lint
sysmanage/
├── backend/ # FastAPI backend
│ ├── api/ # REST API endpoints
│ ├── auth/ # JWT authentication
│ ├── persistence/ # Database models and ORM
│ └── websocket/ # WebSocket communication
├── frontend/ # React frontend (Vite-based)
│ ├── src/Components/ # React components
│ └── src/Pages/ # Page components
├── tests/ # Backend Python tests
├── alembic/ # Database migrations
└── requirements.txt # Python dependencies
When running the backend server, interactive API documentation is available at:
SysManage supports 14 languages with full localization:
| Language | Code | Status |
|---|---|---|
| English | en | ✅ Complete |
| Spanish | es | ✅ Complete |
| French | fr | ✅ Complete |
| German | de | ✅ Complete |
| Italian | it | ✅ Complete |
| Portuguese | pt | ✅ Complete |
| Dutch | nl | ✅ Complete |
| Japanese | ja | ✅ Complete |
| Simplified Chinese | zh_CN | ✅ Complete |
| Traditional Chinese | zh_TW | ✅ Complete |
| Korean | ko | ✅ Complete |
| Russian | ru | ✅ Complete |
| Arabic | ar | ✅ Complete (RTL) |
| Hindi | hi | ✅ Complete |
SysManage implements enterprise-grade security features:
scripts/sysmanage_secure_installation must be run on new installations📖 For complete security documentation, visit sysmanage.org/docs/security/
# Backend
uvicorn backend.main:app --reload --host 0.0.0.0 --port 6443
# Frontend
cd frontend && npm run dev
# Backend
uvicorn backend.main:app --host 0.0.0.0 --port 6443 --workers 4
# Frontend
cd frontend && npm run build
# Serve built files from frontend/dist/
📖 For detailed deployment instructions, visit sysmanage.org/docs/server/deployment.html
This project uses a dual conftest architecture for optimal test performance and database isolation:
/tests/conftest.py: Integration tests with full schema (Alembic migrations)/tests/api/conftest.py: Fast API tests with minimal dependencies (manual models)# Run all tests (backend + frontend + UI + performance)
make test
# Run specific test suites
make test-python # Backend tests only
make test-typescript # Frontend tests only
make test-playwright # UI tests only
make test-performance # Performance tests (Artillery + Playwright + regression analysis)
# Individual test files
python -m pytest tests/api/test_packages.py -v
python -m pytest tests/api/ -q --tb=no
SysManage includes comprehensive performance testing with multi-OS support:
# Run performance tests locally
make test-performance
# Performance requirements
npm install -g artillery@latest # For load testing
playwright install # For browser automation
📊 For detailed performance testing documentation, see PERFORMANCE_TESTING.md
CRITICAL: When adding new models, update BOTH conftest files:
alembic revision --autogenerate -m "Add NewModel"SQLite Compatibility Rules:
Integer primary keys (not BigInteger) for auto-incrementString instead of Text for better performanceDateTime columnsSee TESTING.md for detailed guidelines.
make test lint)📖 For detailed contribution guidelines, visit sysmanage.org/docs/
This project is licensed under the GNU Affero General Public License v3.0. See LICENSE for details.