Open-Source DevOps · guohongze

adminset

AdminSet is a Python-based DevOps platform offering CMDB, asset management, job scheduling, monitoring, and automation capabilities. Recently revived after 7 years with modern stack upgrades (Django 4.2, Python 3.12, Ubuntu 24.04), it provides an integrated operations dashboard with web SSH, role-based access control, and task orchestration.

Talk to DEV.co Discuss Implementation

Source: GitHub — github.com/guohongze/adminset

3.4k

GitHub stars

1.4k

Forks

Python

Primary language

GPL-2.0

License (OSI-approved)

Key facts

Objective fields from the source. Values we can't verify are shown as “Unknown” rather than guessed.

Field	Value
Repository	guohongze/adminset
Owner	guohongze
Primary language	Python
License	GPL-2.0 — OSI-approved
Stars	3.4k
Forks	1.4k
Open issues	75
Latest release	v0.61 (2025-03-16)
Last updated	2025-03-16
Source	https://github.com/guohongze/adminset

What adminset is

Django 4.2 web application supporting MariaDB/MySQL, Redis, and MongoDB for monitoring data, deployed via automated bash script on Ubuntu 24.04. Client agents run on RHEL/CentOS/Ubuntu and communicate via token authentication; Celery handles job scheduling and async tasks. Includes Ansible integration hooks and web-based SSH terminal.

Quickstart

Get the adminset source

Clone the repository and explore it locally.

terminalbash

1git clone https://github.com/guohongze/adminset.git2cd adminset3# follow the project's README for install & configuration

Need it deployed, integrated, or customized instead? DEV.co ships production installs.

Best use cases

On-Premises Infrastructure Management

Centralized CMDB and asset lifecycle tracking for organizations managing physical or private cloud servers; integrates client agents across multiple Linux hosts with SSH-free web console access.

Batch DevOps Workflows

Job scheduling, cron management, and task orchestration for teams running repetitive automation; Celery + Redis backend supports parallel job execution across registered client nodes.

Internal Monitoring & Alerting Dashboard

Custom monitoring UI with MySQL-backed data storage for small-to-medium ops teams; no external SaaS dependency; web SSH eliminates terminal access risk for shared bastion hosts.

Implementation considerations

Automated install targets Ubuntu 24.04 LTS only; manual steps required for other distributions. Root execution required; review auto_install.sh for environment changes (MariaDB setup, systemd services, /var/opt/adminset paths).
Default credentials (admin/admin) must be changed immediately post-deployment; CSRF_TRUSTED_ORIGINS must be configured per environment (manual edit of settings.py if not set during install).
Client agent registration depends on DNS resolution; hostnames must resolve to management IPs in /etc/hosts. SSH key distribution to clients required for full automation feature set.
Monitoring data MySQL schema and retention policy not documented; plan for disk growth if enabling per-server metrics collection.
Celery + Redis workers must be monitored separately; systemctl status commands provided but alerting integration scope unclear.

When to avoid it — and what to weigh

Requires Commercial Support or SLA — Project is community-maintained by a single author. GPL-2.0 license grants no warranty or commercial support guarantees. Production deployments need internal expertise.
Multi-Cloud or Kubernetes Native — Designed for traditional server/VM ops, not container orchestration or serverless. No Kubernetes operators or cloud-native deployment patterns evident.
Strict Security/Compliance for Regulated Industries — README warns against public internet exposure; DEBUG mode enabled by default; webssh flagged as test-only. Audit trails, encryption at rest, and compliance features not clearly documented.
High-Availability Enterprise Deployments — Single-instance architecture assumed; no clustering or failover documented. Suitable for smaller ops teams, not enterprise scale with redundancy requirements.

License & commercial use

GNU General Public License v2.0 (GPL-2.0). Copyleft license requiring derivative works and internal deployments to release source code if distributed. No proprietary extensions or closed-source modules documented.

GPL-2.0 permits internal use without redistribution obligation. Commercial deployment as managed service or repackaged product requires legal review and likely source code disclosure. No license exceptions, commercial support agreements, or dual licensing mentioned. Requires review before commercial SaaS or consulting delivery.

DEV.co evaluation signals

Editorial assessment — not user reviews. Directional, with an explicit confidence level.

Signal	Assessment
Maintenance	Active
Documentation	Adequate
License clarity	Clear
Deployment complexity	Moderate
DEV.co fit	Possible
Assessment confidence	High

Security considerations

README explicitly warns against public internet exposure and flags webssh as test-only. DEBUG mode enabled by default (must disable in production). Default admin credentials and token-based agent auth present initial compromise vectors. Monitoring data transmission encryption not specified. No mention of input validation, SQL injection mitigations, or rate limiting. SSH key-based client authentication relies on server-side security posture (not automatically hardened). CSRF_TRUSTED_ORIGINS configuration critical but manual. Internal-use-only deployment recommended until security audit completed.

Alternatives to consider

Foreman / Orcharhino

Established CMDB + config management with Puppet/Ansible; multi-OS support; commercial backing; more audit/compliance features.

NetBox

Modern Python/Django CMDB focused on network + infrastructure inventory; cleaner REST API; active community; no job scheduling (use with Nautobot for automation).

Rundeck

Dedicated job scheduler + orchestration; strong RBAC and audit logging; supports ad-hoc commands; cloud-native deployment; commercial + open-source options.

Software development agency

Build on adminset with DEV.co software developers

If managing on-premises Linux infrastructure with internal DevOps workflows, request a technical assessment from our team. We can review GPL-2.0 licensing fit, security hardening requirements, and integration with your existing stack.

Talk to DEV.co

Related open-source tools

Surfaced by semantic similarity across the DEV.co open-source index.

LazyAdmin irmin assh

Related on DEV.co

Explore the category and the services that help you build with it.

Open-Source DevOps DevOps & Infrastructure Automation Enterprise Software Solutions Custom Software Development Talk to DEV.co

adminset FAQ

Can I use AdminSet in production without support?

Technically yes, but GPL-2.0 offers no warranty or SLA. You must have internal Linux sysadmin expertise to troubleshoot issues, apply security patches, and maintain MariaDB/Redis/Celery stacks.

Does AdminSet support cloud platforms (AWS, Azure, GCP)?

Not natively. It manages VMs/servers via SSH client agents. Cloud-specific features (IAM, auto-scaling, managed services) require external integration. Use for on-premises or IaaS VMs only.

Is webssh safe for production?

No. README explicitly warns it is test-only and forbids public network use. It bypasses terminal-based session controls and audit trails. Use only for internal, isolated environments or replace with secure bastion alternatives.

What happens if I lose the Redis or MariaDB instance?

Unknown. No documentation on backup/recovery, HA, or data durability. Production deployments must implement external DB replication and Redis persistence independently.

Custom software development services

Adopting adminset is usually one piece of a larger software development effort. As a software development agency, DEV.co provides software development services and web development expertise — pairing senior software developers and web developers with your team to design, build, and operate open-source devops software in production.

Evaluate AdminSet for Your Infrastructure Team

Talk to DEV.co Schedule a Consultation