From 2023ab93752c0231637514ea97118a6a434e64e4 Mon Sep 17 00:00:00 2001 From: Oscar Levin Date: Sun, 2 Aug 2026 09:33:13 -0600 Subject: [PATCH 1/2] Clarify step 7 of build process --- docs/source/building_servers.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/source/building_servers.rst b/docs/source/building_servers.rst index 4224d55ce..ef263063d 100644 --- a/docs/source/building_servers.rst +++ b/docs/source/building_servers.rst @@ -23,7 +23,7 @@ Now you are ready to install the required dependencies and build the servers: Future instructions will make it clear which commands need to be run inside the virtual environment by always including ``uv run ...`` at the start of the command. This is what you will need to type if you are **NOT** in the activated virtual environment. If you activate the virtual environment, you will be able to skip typing ``uv run``. For example, to check the environmental variables, you would type ``uv run rsmanage env`` if the virtual environment is not active; if the virtual environment is active, you would just type ``rsmanage env``. -7. Run the ``build`` script from the ``rs`` folder by doing ``build full``. The first step of this script will verify that you have all of your environment variables defined. It will then build the python wheels for all the runestone components and then build the docker servers. This will take a while. +7. Run the ``build`` script from the ``rs`` folder by doing ``uv run build full`` (or just ``build full`` if you are still in the virtual environment). The first step of this script will verify that you have all of your environment variables defined. It will then build the python wheels for all the runestone components and then build the docker servers. This will take a while. Starting the Servers From 4d0e1ac0d7151babaf7be33ec53301f1e2392a50 Mon Sep 17 00:00:00 2001 From: Oscar Levin Date: Sun, 2 Aug 2026 10:16:14 -0600 Subject: [PATCH 2/2] Clarify that `uv run...` is better because it picks up .env settings --- docs/source/building_servers.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/source/building_servers.rst b/docs/source/building_servers.rst index ef263063d..5702cd5f0 100644 --- a/docs/source/building_servers.rst +++ b/docs/source/building_servers.rst @@ -23,7 +23,8 @@ Now you are ready to install the required dependencies and build the servers: Future instructions will make it clear which commands need to be run inside the virtual environment by always including ``uv run ...`` at the start of the command. This is what you will need to type if you are **NOT** in the activated virtual environment. If you activate the virtual environment, you will be able to skip typing ``uv run``. For example, to check the environmental variables, you would type ``uv run rsmanage env`` if the virtual environment is not active; if the virtual environment is active, you would just type ``rsmanage env``. -7. Run the ``build`` script from the ``rs`` folder by doing ``uv run build full`` (or just ``build full`` if you are still in the virtual environment). The first step of this script will verify that you have all of your environment variables defined. It will then build the python wheels for all the runestone components and then build the docker servers. This will take a while. + +7. Run the ``build`` script from the ``rs`` folder by doing ``uv run build full`` (or if still in the virtual environment, just ``build full``). The first step of this script will verify that you have all of your environment variables defined. It will then build the python wheels for all the runestone components and then build the docker servers. This will take a while (on the order of 30-90 minutes). More details about the build server is given below. Starting the Servers