Skip to main contentIBM Quantum Documentation Preview

Instances

Access to IBM Quantum™ Platform services is controlled by the instances (previously called providers) to which you are assigned. An instance is defined by a hierarchical organization of hub, group, and project. A hub is the top level of a given hierarchy (organization) and contains within it one or more groups. These groups are in turn populated with projects. The combination of hub/group/project is called an instance. Users can belong to more than one instance at any given time.

Note

IBM Cloud® instances are different from IBM Quantum Platform instances. IBM Cloud does not use the hub/group/project structure for user management. This section describes instances in IBM Quantum Platform. To view and create IBM Cloud instances, visit the IBM Cloud Quantum Instances page(opens in a new tab). Click the name of an instance to see details such as your CRN for that instance, what compute resources are available to you by using that instance, and what jobs you have run on that instance.

Alice, Bob, and Charlie are all in Hub A.  Hub A has Group 1 and 2.  Alice and Bob are in Group 1.  Charlie is in Group 2.  Group 1 has Project X and Y.  Alice is in both projects.  Bob is only in project X.  Group 2 has Project Z.  Charlie is in project Z.  Therefore, Charlie's instance is Hub-A/Group-2/Project-Z.
Hub / group / project hierarchy

The hub/group/project hierarchy that makes up an IBM Quantum instance.

Users with a public account automatically belong to the ibm-q/open/main Open Plan. For organizations outside of IBM®, designated hub or group administrators assign users to instances.

To see the instances to which you have access, look at the bottom of your Account page(opens in a new tab).

Screenshot of the Account page.
Instances on the Account page

Find your instances

You can view a list of your instances on your account settings page(opens in a new tab), or you can use the instances() method.


Switch instances

If you have access to run on multiple instances, the IBM Quantum interface(opens in a new tab) menu bar contains a dropdown that lets you switch between instances. The IBM Quantum Platform dashboard, Compute resources, and Jobs pages display information such as usage metrics, jobs, and QPUs based on the selected instance.

Note

The instance switcher does not appear in the Administration application.

If you switch to a different instance, it is remembered the next time you log on and, assuming that it's still a valid instance, information pertaining to that instance is displayed. By default, the first premium instance you have access to is used. If you do not have any premium instances, the first open instance is shown.

Note

The first instance is determined alphabetically.


Instances and jobs

When you execute a task using an IBM Quantum service (for example, sending circuits to a QPU), a job instance is returned to you. Regardless of which service is being used, a job can track the progress of the submission through IBM Quantum, and retrieve the final result(s) of the computation. Because services are coupled to instances, the jobs created from these services are also tied to the specific instance being used. Therefore, if a user is removed from an instance, their jobs and the associated results are no longer accessible.


Open Plan

By default, users who sign up for an IBM Quantum account are assigned to the Open Plan and the Open Plan's instance, ibm-q/open/main. To guarantee that everyone can use the QPU allocated to the plan fairly, an individual can have no more than three jobs running and/or in the queue (across all QPUs) at the same time. Submitting more than three jobs at a time will return error #3458, and additional jobs will be canceled.

Those using the Open Plan instance have up to 10 minutes total of quantum time per month, which resets at 00:00:00 UTC on the first of each calendar month. Open Plan users can track their usage on the Platform dashboard(opens in a new tab), Jobs(opens in a new tab), and Account(opens in a new tab) pages.


Connect to an instance

You can specify an instance when initializing the service or provider, or when choosing a QPU. You can copy the service-level code by clicking the three dots by the instance name on the Instances section of the Account overview page(opens in a new tab).

qiskit-ibm-runtime

 
# Optional: List all the instances you can access.
service = QiskitRuntimeService(channel='ibm_quantum')
print(service.instances())
 
# Optional: Specify it at service level. This becomes the default unless overwritten.
service = QiskitRuntimeService(channel='ibm_quantum', instance="hub1/group1/project1")
backend1 = service.backend("ibmq_manila")
 
# Optional: Specify it at the backend level, which overwrites the service-level specification when this backend is used.
backend2 = service.backend("ibmq_manila", instance="hub2/group2/project2")
 
sampler1 = SamplerV2(mode=backend1)    # this will use hub1/group1/project1
sampler2 = SamplerV2(mode=backend2)    # this will use hub2/group2/project2

qiskit-ibm-provider

from qiskit_ibm_provider import IBMProvider
 
provider = IBMProvider(instance="hub1/group1/project1")
backend1 = provider.get_backend("ibmq_manila")
backend2 = provider.get_backend("ibmq_manila", instance="hub2/group2/project2")
 
job1 = backend1.run(...)    # this will use hub1/group1/project1
job2 = backend2.run(...)    # this will use hub2/group2/project2
Note

If you do not specify an instance, the code will select one in the following order:

  1. If your account only has access to one instance, it is selected by default.
  2. If your account has access to multiple instances but only one can access the requested QPU, the instance with access is selected.
  3. In all other cases, the code selects the first instance other than ibm-q/open/main that has access to the QPU.

Leaving an instance

To leave an instance, visit the instance list on your Account page.(opens in a new tab) Select the instance you wish to leave, then select the overflow menu and choose Leave instance.

Screenshot of the Account page.
Leave instance

Next steps

Recommendations