---

name: server-ops description: "Operate and deploy Argilla server 2.8.0dev0 with safe CLI, configuration, Docker, Spaces, Kubernetes, OAuth, telemetry, reindexing, and troubleshooting guidance." disable-model-invocation: true metadata: disco-role: operating license: Apache 2.0

Argilla server operations

Use this sub-skill when the user needs to deploy, configure, start, migrate, reindex, secure, or debug the Argilla server stack. It covers Argilla 2.8.0dev0 server behavior, not dataset authoring with the Python SDK or legacy v1/Rubrix migration.

Route to this sub-skill for

• Choosing between Hugging Face Spaces, rg.Argilla.deploy_on_spaces, local Docker Compose, direct Python server package use, and Kubernetes/Helm-style deployments.
• Writing or reviewing server environment variables for database, search engine, Redis, base URL/proxy, CORS/docs, OAuth/SSO, auth secret, dataset limits, telemetry, and Docker startup defaults.
• Using the python -m argilla_server CLI for start, database, database users, search-engine reindex, and worker operations.
• Debugging server startup, private Space access, persistent storage, OAuth redirect, Elasticsearch/OpenSearch, PostgreSQL/SQLite, Redis, Docker logs, reindexing, or Typer/Click CLI dependency issues.

Do not handle here

• Current Argilla SDK dataset/settings/records/search/webhook code: route to python-sdk.
• Legacy v1/Rubrix dataset migration: route to legacy-migration.
• Internal frontend development, repo CI, docs-generation, notebooks, or live service integration tests.

Bundled references and scripts

• Read references/deployment.md when choosing a deployment path, adapting the bundled Compose file, planning Hugging Face Spaces, or giving Kubernetes/proxy guidance.
• Read references/server-cli-and-config.md when you need exact argilla_server CLI commands, startup order, environment variables, OAuth YAML shape, or telemetry/auth configuration.
• Read references/troubleshooting.md when startup, search, DB, Redis, OAuth, private Space, proxy, reindex, Docker, or CLI dependency symptoms need diagnosis.
• Use scripts/docker-compose.argilla.local.yaml as a self-contained local Compose template only when the user intentionally wants a local service stack; validate with docker compose -f ... config before running and replace sample credentials first.
• Run scripts/check_server_cli.py to safely verify that argilla_server imports and that root/start/database/search-engine/worker CLI help renders without starting services.

Operating safety

• Treat all server starts, Docker/Kubernetes operations, migrations, reindexing, user creation, and Hugging Face Space deployment as user-approved operations because they can create services, mutate databases/search indexes, or contact external APIs.
• Prefer help/config checks first. The bundled CLI helper renders help only; it does not start Uvicorn, workers, migrations, databases, Redis, search engines, Docker, or network calls.
• Never use real credentials in examples. Replace sample usernames, passwords, API keys, OAuth secrets, and auth secret keys before any shared or production deployment.