Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

[Doc] Add venv for Ubuntu 24.04 #214

Merged
merged 1 commit into from
Sep 4, 2024
Merged

[Doc] Add venv for Ubuntu 24.04 #214

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 20 additions & 0 deletions Documentation/index.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -54,6 +54,26 @@ pip. GSC requires Python 3.6 or later.
sudo apt-get install docker.io python3 python3-pip
pip3 install docker jinja2 tomli tomli-w pyyaml

Python venv workaround for Ubuntu 24.04
---------------------------------------

Unfortunately, Ubuntu 24.04 (noble) has a `bug that prevents out-of-the-box
execution of
GSC <https://bugs.launchpad.net/ubuntu/+source/python-docker/+bug/2065348>`__.

Until this bug is fixed, GSC must be run on Ubuntu 24.04 via Python virtual
environment (venv). Please perform the following steps to install and activate
venv for GSC:

.. code-block:: sh

sudo apt-get install python3-venv
python3 -m venv my_venv && source my_venv/bin/activate
pip3 install 'docker>=6.1.0' jinja2 tomli tomli-w pyyaml

Now you can execute GSC commands (`gsc build`, `gsc sign`, etc.) as usual,
within the virtual environment confines.

SGX software stack
------------------

Expand Down