Upgrading Student Projects
The Configuration tab of a .course
file allows you to upgrade students’ course projects in two ways:
Students Pay For Upgrades
You can request that the students pay for CoCalc resources needed for the course. You set exactly which resources are needed, as well as the start and end dates.
Note
As of August, 2023, students in a course must buy the license specified for that course. Upgrading the student project in some other way is not sufficient.
1. Instructor configures the payment option
In the course Configuration tab, choose Students pay directly and adjust parameters as needed:
Hint
If you are running multiple sections of the same course, you probably want to configure these licenses to be exactly the same including the dates, so that students in different sections pay exactly the same fee.
3. Students make payments
After clicking the banner, they will see a button allowing them to pay for the course:
Teacher or Institute Pays for Upgrades
You can buy a license that will upgrade all student projects. The same license can be used to upgrade the main course project as well.
1. Configure the payment option
In the course Configuration tab, choose You or your institute will pay for this course:
2. Apply a license to the course
If you already have a license for this course, click Upgrade using a license key…. Otherwise use Buy a license… button below, get a license, and come back to the course.
Once you successfully apply your license key, you will see its details including the maximum number of simultaneously running projects:
Warning
You must use a license with at least the same limit of running projects as the number of enrolled students. (Plus 2 if you use the same license for the instructor project as well as the shared project.) Otherwise some students may not be able to get the upgrades, preventing them from completing their work.
Hint
You can easily adjust the number of projects your license can upgrade at any time if your enrollment number changes - click on the license description and then Edit license… button!
3. Apply the course license to the instructor project (optional)
You can use the same license that you’re using for the students to upgrade the instructor project. This will count against the maximum number of running projects for the license. With this option, if you have 20 students and plan to run your instructor project at the same time as all 20 students, your course license should allow for at least 21 projects.
If using this option, click Upgrade instructor project and then Save:
Then you have to manually restart the project to apply the license: click Settings and then Restart Project…
Hint
While it is convenient to use the course license for the instructor project, you should consider if having more RAM or a longer timeout would be beneficial to you. In that case you can buy a more powerful (and more expensive) license just for one project and apply it in project settings.
4. What do students see
Here is what a student will see upon opening the student project for the course.
First, this is what is seen if the instructor has not yet applied a license for the course. Note the red banner warning that the project is not upgraded.
Second, this is what is seen if the instructor has added a license in the course Configuration tab. The exact resource amounts will vary depending on the license.
5. License strategy (multiple licenses only)
Warning
Using multiple licenses for a course was necessary before it was possible to edit an existing license. Now using multiple licenses is discouraged.
If you have applied two or more licenses to a course, a dialog appears for choosing how those licenses are combined. The two options are:
Maximize number of covered students: apply one license to each project associated to this course (e.g., you bought a license to handle a few more students who added your course). This is the default.
Maximize upgrades to each project: apply all licenses to all projects associated to this course (e.g., you bought a license to increase the RAM or CPU for all students).
Problems with Licenses
If a license does not seem to be correctly applied to a student project, first check that the student project has been restarted since adding the license. If there is still a problem, see License Error Messages.
Adding Capacity
After you have courses up and running, you may discover that you need to provide for more students, or increase computing resources on student projects. You can do this by editing your license at any time!
Teaching with Compute Servers
If CoCalc projects are not sufficient for your needs, e.g. because you need GPUs or more CPU cores, you can consider Teaching with Compute Servers!
Charges for Paid LLMs
Just as other users, students are free to use CoCalc AI Assistant. If they want to use paid LLMs, they will have to put some money on their accounts. If you want your students to work with advanced LLMs and you want to pay for that, you can use CoCalc Credit Vouchers to distribute funds, similar to Teaching with Compute Servers. If, on the other hand, you want to discourage students from using AI, you can turn it off for their projects, see Restrict Student Projects.