Skip to main content
When you connect a Buildkite organization, Namespace creates and registers the first managed queue during setup. A new Namespace Cluster uses the default queue; an existing cluster uses the queue name selected during setup.

​
Register another queue

  1. In Buildkite, navigate to Agents and select the cluster where you want to run Namespace agents.
  2. Create a new self-hosted queue.
  1. Open Buildkite → Organizations in the Namespace dashboard. Click on the organization you want to manage, and then click Queues. This page lists all registered and unregistered queues, grouped by Buildkite cluster.
  2. Find the queue and click Register.
  3. Confirm the registration. Namespace creates an agent token and begins acquiring jobs from the queue.
Make sure that your webhook is configured to send events from the pipelines using this queue.Webhook Settings →

​
Select a queue for a job

Set the queue agent tag on a pipeline or step to send jobs to the registered queue:

​
Unregister a queue

In the Namespace Queues page, open the menu next to a registered queue, select Unregister, and confirm. A queue cannot be unregistered while it has scheduled or running jobs in Namespace. Unregistering a queue stops Namespace from provisioning agents for it and revokes the agent token created during registration. It does not delete the queue or its cluster from Buildkite.

​
Next Steps

Configure Buildkite Agents. Choose compute resources, base images, and persistent caches with agent tags.
Last modified on August 24, 2026