diff --git a/cSpell.json b/cSpell.json index a7aebacf295..d27b29ac30a 100644 --- a/cSpell.json +++ b/cSpell.json @@ -155,6 +155,7 @@ "Unroller", "Vazirani", "Vedral", + "venv", "Watrous", "Weyl", "Woerner", diff --git a/docs/start/install.mdx b/docs/start/install.mdx index 7e12dd28111..aec3355ebff 100644 --- a/docs/start/install.mdx +++ b/docs/start/install.mdx @@ -8,6 +8,16 @@ description: Install and set up Qiskit and Qiskit Runtime on various operating s Whether you will work locally or in a cloud environment, the first step for all users is to install Qiskit®. For those wanting to run on a real system, your next step is to choose one of two channels in order to access IBM Quantum™ systems: IBM Quantum Platform or IBM Cloud®. + + (If you are installing Qiskit for the first time, skip ahead to the [Install and set up](#local) section. This notice is relevant only to users who have installed Qiskit previously.) + + **For those upgrading from version 0.x to 1.0 or later**: note that because Qiskit 1.0 uses a new packaging structure, you **cannot** use `pip install -U qiskit` to upgrade from any Qiskit 0.x version to 1.0. + + See the [Qiskit 1.0 migration guide](/api/migration-guides/qiskit-1.0) for details and instructions. + + Future updates starting with Qiskit 1.0 will allow for in-place upgrades. + + ## Install and set up Qiskit with the Qiskit Runtime client