Skip to content

mickahell/quantum_lab

Repository files navigation

Quantum Lab

All Contributors

DOI
Docker Image CI Docker TAG CI GitHub release (latest by date)

Docker Pulls

The next images are now depreciated, please use the Qiskit one just above.

  • Old images

    Docker Pulls Docker Pulls Docker Pulls Docker Pulls Docker Pulls Docker Pulls

Prerequisites

  • Linux
    apt-get install docker-ce docker-ce-cli containerd.io

Details

Getting started

Build

docker build . --file Dockerfile --tag quantum_lab_qiskit

Run

docker run -d --name qiskit_lab \
  -v $PWD/YOUR_DATA_FOLDER:/opt/quantum_lab/data/share \
  -p 8888:8888 \
  mickahell/quantum_lab_qiskit:latest /opt/quantum_lab/start_jupyter.sh
  • copy and paste this url in your browser : http://127.0.0.1:8888/ to open the jupyter interface.
  • everyfile in the share folder gonna be sync with your local volume.

Volume

The folder data/share is link to the host file and allow to register the modification in the host computer

Simple docker commands

  • List the existed images : docker images
  • List the existed containeur : docker ps -a
    • The -a is used the see every existed containeurs, that's include the stopped one
  • To start a containeur : docker start [CONTAINEUR_ID]
  • To go inside a started containeur : docker exec -it -u root [CONTAINEUR_ID] /bin/bash
  • Delete containeur : docker rm [CONTAINEUR_ID]
  • Delete stopped container : docker container prune
  • Delete image : docker rmi [NAME_OF_THE_IMAGE]
    • You can use -f to force the suppression and delete the containeurs associated to the image
  • List the existed volume : docker volume ls
  • Delete volume not used anymore : docker volume prune

Cite as

If you use my work, please cite as :

Quantum Lab: Docker image for quantum laboratory, Michaël Rollin, 2021, DOI: 10.5281/zenodo.4664195

Contributors ✨

Thanks goes to these wonderful people (emoji key):


Mica

💻 📖

Alberto Maldonado

👀

This project follows the all-contributors specification. Contributions of any kind welcome!