> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ionq.com/llms.txt
> Use this file to discover all available pages before exploring further.

# IonQ API Key Management with dotenv Integration

> Discover how to effortlessly manage IonQ API keys across various projects by leveraging dotenv's automatic loading feature, enhancing security and codebase cleanliness.

## Leveraging dotenv for IonQ API Key Management

Storing and managing API keys securely is paramount in software development, especially when dealing with sensitive services like IonQ's quantum computing API. There are a couple of methods for securely storing your IonQ API key where integrations like `qiskit_ionq` can automatically find it: you can [store it locally in an environment variable on your system](/guides/managing-api-keys#storing-keys) as described in our main API key guide, or use dotenv as shown here.

This guide introduces a streamlined approach to handle IonQ API keys using dotenv, which automatically loads `.env` files, thus simplifying the management process across different projects. Using dotenv may be easier than using your system's environment variables, depending on your particular setup and preferences.

## Prerequisites

Before diving in, ensure you have:

* Registered on the [IonQ Quantum Cloud](https://cloud.ionq.com) and generated your API keys. Visit IonQ's [API key management guide](/guides/managing-api-keys) for detailed instructions.
* Python 3.11 installed on your computer. Confirm your Python version with `python --version` via command line.

<Tip>
  To prevent dependency conflicts, consider utilizing an environment manager
  like [virtualenv](https://virtualenv.pypa.io/en/latest/) or
  [conda](https://docs.conda.io/en/latest/).
</Tip>

## Step 1: Creating a .env File

Navigate to the root directory of your project and create a `.env` file. This file will host your project-specific settings, including the IonQ API key, keeping them secure and easily accessible.

## Step 2: Adding the IonQ API Key to the .env File

Open the `.env` file in a text editor and insert your IonQ API key as shown below:

```plaintext theme={null}
IONQ_API_KEY=your_api_key_here
```

Replace `your_api_key_here` with your actual IonQ API key. After saving the file, your key is securely stored and ready for use.

<Tip>
  Don't forget that sharing the `.env` file that contains your API key would mean sharing access to your IonQ account and resources. If you unintentionally share the file, you can always revoke an API key from the IonQ Cloud Console.
</Tip>

## Step 3: Ensure dotenv Package Installation

The IonQ Provider for Qiskit has been designed to check for and automatically load `.env` files. If you haven't already, ensure the `python-dotenv` package is installed in your environment:

```bash theme={null}
pip install python-dotenv
```

## Step 4: Using the IonQ API Key in Your Project

With the `python-dotenv` package installed and your `.env` file configured, the `IonQProvider` is now set to automatically load and use the API key from the `.env` file without any additional code for dotenv loading in your script.

With this automatic loading feature, accessing the IonQ API key in your project code is straightforward. Here's an example with the IonQ Provider for Qiskit:

```python theme={null}
from qiskit_ionq import IonQProvider

# The IonQProvider automatically looks for the IONQ_API_KEY in your environment
provider = IonQProvider()
```

This setup ensures your IonQ API key is automatically detected and utilized, streamlining the development process.

## Conclusion

You've successfully learned how to manage IonQ API keys more efficiently using dotenv's automatic loading functionality. This approach not only secures your API keys by keeping them out of your codebase but also simplifies configuration management across multiple projects.

For additional information on quantum computing and project management with IonQ, explore the comprehensive [IonQ documentation](https://ionq.com/docs).