How to Deploy Jupyter Notebook on Zenifra

First Step

Log in to the console, select the Create Project tab on the left menu.

After selecting Create Project, we'll start gathering the necessary information!

Second Step

Field Details

Project Name

The project name is important for organizing projects and for the domain!

Here, you can choose any name you want, but a tip: For projects on the "basic" plan, the domain name to be used will be the project name.

Image

The project image is an OCI-standard image!

For the Jupyter Notebook, we'll use the latest available image, which is:

quay.io/jupyter/scipy-notebook:2025-03-14

For more information about Jupyter Notebook and its different images, visit the external link: Jupyter Notebook

Registry

For the Jupyter Notebook, we'll use a public image that doesn't require authentication to download!

Plan

For testing purposes, we'll proceed with the "Basic" plan, which provides sufficient resources to run various Jupyter Notebook projects and is the most affordable plan!

If you want to use heavier scripts, such as for running machine learning, deep learning, etc., we have instances with dedicated NVIDIA GPU support.

Persistent Storage

For testing purposes, we'll proceed without persistent storage, but if you want to save projects on this instance and don't want to worry about losing data, select "Yes"

Storage Size

Depending on the plan and whether storage is persistent or not, storage can be free or paid!

For testing, we'll proceed with a size of 5GB, which all plans provide 5GB of free storage for temporary use.

Port Number

By default, the Jupyter Notebook runs on port 8888!

Payment Plan Model

Here, since we'll be running this for testing purposes, we'll select the "hourly" model, which will charge a minimum of 1 hour of project usage.

Number of Instances

For the Jupyter Notebook, we'll proceed with just 1 instance, as it doesn't perform load balancing by default.

Environment Variables

To access the Jupyter Notebook, we'll need to create a token!

The token acts as a password for the Jupyter Notebook, which can be changed at any time!

For testing purposes, we'll proceed with the following:

JUPYTER_TOKEN = test

Total Cost

In this section, you can view the total cost of the project!

Remember that Zenifra offers discounts for properly enrolled students and free access for partnered schools and universities!

In addition, new users get R$30 monthly for 3 months to use as they like, on any plan!

Third Step

After filling in all the information above, click the "Create Project" button, which may take a few seconds to complete the project creation!

Once created, a new tab will automatically open showing the URL of the project to access.

Click on this link, which will open a new tab in your browser, redirecting you directly to the created Jupyter Notebook!

Finalizing

If you want to stop/terminate the instance, go to the Projects tab, search for the created project, and click on the project name, which will open a new page containing the project's information.

When accessing the screen, click on "Settings" and "Delete," which will properly delete the project.

For more information on this screen and how to gain insights from your business, proceed to the next documentation!