Zom Hauptinhalt springe

⚙️ doQumentation-Instellunge

Konfigureeert dä Jupyter-Server, dä för de Ußföhrung vun Python-Code en Tutorials jenutzt weed.

Aktuell Umjebung: Not detected

Server Backend

Choose which backend to use for code execution:

Execution Modeⓘ

Choose what happens when you click Run on tutorial pages. This applies to embedded code execution on this site only — opening a notebook in JupyterLab uses the standard Qiskit runtime.

Changes take effect on the next kernel session. If code is running, click Back then Run to apply.

IBM Quantum-Konto

Setup instructions & security notes
Secherheitshendeiss: Zugangsdaate weede en Ührem Browser singe localStorage als Klartext jespeichert. Se sin nit verschlösselt un künne vun Browser-Erweiterunge oder jedereine met Zogriff op dat Jerät jelässe weede. Benutzt de Avlaaf-Instellung unne för Belastung ze begränze, un löscht de Zugangsdaate, wann Ehr fäädich sitt. För jedeilde oder öffentliche Computer, bevorzecht de manuelle save_account()-Method, die unne beschrevve es.

Jitt Ühr IBM Quantum-Zugangsdaate einmol hee en. Se weede övver save_account() beim Kernel-Start auto-injizeet, su dat Ehr se nit en jedes Notebook enjavve müsst. Dat jelld nur för einjebettde Code-Ußföhrung op dä Sigg hee — för e Notebook en JupyterLab ze öffne, moss save_account() manuell oproofe weede.

  1. Rejistreeere bei quantum.cloud.ibm.com/registration — kein Kredikaat för de erschde 30 Dääch nüdich
  2. Enmelde bei Instances
  3. Instanz — Määt en kostenlose Open Plan-Instanz bei home page, wann Ehr noch kein hant
  4. API Token — Kleckt op Ühr Profil-Symbol (bovve rähts), dann "API token". Kopeert dä Schlössel.

För detailleete Schrett, luurt en IBM singe Authentifizeerung inrichte-Leitfade (Schrett 2).

Alternativ: save_account() manuell en ener Notebook-Zell laufe losse

Wann Ehr et bevorzecht, kein Zugangsdaate en däm Browser ze speichere, plakkt dat hee en en beleebije Code-Zell un loot se laufe. Zugangsdaate weede em temporäre Speicher vum Binder-Kernel jespeichert un sin futsch, wann de Sitzung endet.

from qiskit_ibm_runtime import QiskitRuntimeService
QiskitRuntimeService.save_account(
    token="YOUR_API_TOKEN",
    instance="YOUR_CRN",
    overwrite=True
)

Aanzeijeeinstellunge

Code-Schreffjrüüße

14px
from qiskit import QuantumCircuit

Vorberechnete Ußjaabe

Jede Notebook-Sigg zeich vorberechnete Ußjaabe (Bellder, Tabelle, Text) vun IBM singe ursprüngleche Lööf. Wann Ehr Run kleckt för Code live ußzeföhre, weede sowohl de ursprüngleche Ußjaabe als och Ühr neue live Resultaate nevveenander jezeich. Aktiveet dä Toggle för de ursprüngleche Ußjaabe während live Ußföhrung ze verstecke, un nur Ühr Resultaate sechtbor ze maache.

Python-Warnunge

Standardmäßich weede Python-Warnunge (Avschaffungs-Hendeise, Laufzigk-Tipps) ongerdröck för suberere Notebook-Ußjaab. Deaktiveet dat för all Warnunge ze siehn — nötzlich för Fehlerbehebung oder för övver API-Änderunge ze länne.

Manage Your Data

All data is stored locally in your browser (localStorage). Nothing is sent to our servers. Clearing your browser data or using a different browser/device starts fresh.

Lännfortschrett

Ühr Läs- un Ußföhrungs-Fortschrett weed lokal en Ührem Browser verfollt. Besöökde Sigge zeije en ✓ en de Siggeliss; ußjeföhrde Notebooks zeije en ▶.

Noch kein Fortschrett verfollt. Besöök Tutorials un Anleitunge för ze aanfange.

Lesezeiche

No bookmarks yet. Use the bookmark button on any page to save it here.

Display & UI

Sessions & Credentials

Reset Everything

Remove all saved data including progress, bookmarks, display preferences, and credentials.

Advanced Settings

IBM Cloud Code Engine

IBM Cloud Code Engine provides a fast, serverless Jupyter kernel powered by your own IBM Cloud account. Startup takes seconds instead of minutes. Free tier covers ~14 hours/month.

Setup Instructions
  1. Create an IBM Cloud account at cloud.ibm.com (free tier available)
  2. Go to the IBM Cloud Code Engine console and create a new project in your preferred region
  3. Create a new application with image ghcr.io/janlahmann/doqumentation-codeengine:latest, listening port 8080
    Sizing: 1 vCPU / 2 GB for single user, 8 vCPU / 16 GB for workshops (up to 80 users)
  4. Set environment variables: JUPYTER_TOKEN to a secure token (min 32 characters) and CORS_ORIGIN to your domain (e.g. https://doqumentation.org)

For workshop sizing details, see the workshop setup documentation.

Binder-Pakete

Wann op GitHub Pages jelaufe weed, weed Code övver MyBinder ußjeföhrt. De Binder-Umjebung hät Qiskit-Hauptpakete vorigestalleet:

qiskit[visualization], qiskit-aer,
qiskit-ibm-runtime, pylatexenc,
qiskit-ibm-catalog, qiskit-addon-utils, pyscf

Einije Notebooks benüdije zosätzliche Pakete. Ehr künnt se op Aanfraach installeeere, endem Ehr dat en ener Code-Zell laufe loot:

!pip install -q <package>

Oder all optionale Pakete op ens installeeere:

!pip install -q scipy scikit-learn qiskit-ibm-transpiler \
  qiskit-experiments plotly sympy qiskit-serverless \
  qiskit-addon-sqd qiskit-addon-mpf \
  qiskit-addon-aqc-tensor[aer,quimb-jax] \
  qiskit-addon-obp qiskit-addon-cutting ffsim \
  gem-suite python-sat

Inrichtungs-Hölp

RasQberry-Inrichtung

Wann Ehr op enem RasQberry Pi loof, sollt dä Jupyter-Server automatisch erkannt weede. Wann nit, stellt secher, dat de jupyter-tutorials-Döngs läuf:

sudo systemctl status jupyter-tutorials

Lokale Jupyter-Inrichtung

Start ene Jupyter-Server met CORS aktiveet:

jupyter server --ServerApp.token='rasqberry' \
  --ServerApp.allow_origin='*' \
  --ServerApp.disable_check_xsrf=True

Docker-Inrichtung

Dä Docker-Container jeneeet beim Start en zofällijet Jupyter-Token. Code-Ußföhrung övver de Websigg (Port 8080) funkzioneet automatisch — kein Token nüdich. Dat Token es nur för diräkte JupyterLab-Zogriff op Port 8888 erforderlich.

För dat Token us de Container-Logs ze hahle:

docker compose --profile jupyter logs | grep "Jupyter token"

För en festes Token ze setze:

JUPYTER_TOKEN=mytoken docker compose --profile jupyter up

Fännserver

För Fännserver, stellt secher, dat CORS konfigueet es för Verbindunge vun dä Sigg hee ze erlaube. Fööcht dat Folgende zo Ühr jupyter_server_config.py derbei:

c.ServerApp.allow_origin = '*'
c.ServerApp.allow_credentials = True