Files in Workspaces

Each Workspace includes a built-in file manager that lets you work with files and folders directly from the Yeedu UI — no external tools required.

You can:

• Upload files and folders from your local machine.
• Create new files, folders, Git-synced folders, and Notebooks.
• Edit file contents in a browser-based text editor.
• Organize files using rename, move, and copy operations.
• Use files in Jobs — select any uploaded script and create a Job directly from it.

Navigating to Files in Workspaces

To access the Files in Workspaces feature, follow these steps:

• Navigate to the Workspaces tab.
• Click on Files in Workspaces.
• The file management interface will be displayed, allowing to interact with files and folders.

File Management Operations

Uploading a File/Folder

• Click the Upload button in the top-right corner.
• Select the file from your system and click Open.
• The file will be uploaded to the selected workspace.

Creating a New File / Folder / Git Folder / Notebook

To create anything new in the workspace:

Click the + New button

Located at the top-right corner of the workspace UI.

1. Create a File

• Choose File from the type selector.
• Enter a file name.
• Start editing in the workspace editor.

2. Create a Folder

• Choose Folder as the type.
• Enter a folder name.
• The folder is created instantly and ready for use.

3. Create a Git Folder

• Choose Git Folder as the type.

• Provide the required Git details:

  • Git URL
  • Git Provider (currently supports GitHub only)
  • Git Branch
  • Folder Name (name you want to give the synced Git repo)

• Select Credential:

  • Choose an existing credential for that Git provider, or
  • Click + Credential to create a new one.

The system will fetch the repository contents and create a Git-synced folder inside your workspace. Any changes pushed to the specified branch in the remote repository are reflected in this folder, keeping your Workspace files in sync with the source repository.

4. Create a Notebook

• Choose Notebook as the type.

• Fill the required configuration:

  • Name

  • Type (Python3, Scala, SQL)

  • Cluster Name (select the cluster where this notebook will run)

  • Path (location inside the workspace)

  • Maximum Concurrent Notebook Runs

    • Increase this value if you want multiple runs of the same notebook to execute in parallel.

• Advanced Options

  • Append (checkbox) Determines whether job-level Spark configs append to or override cluster-level Spark configs.
  • Packages
  • Jars
  • Files
  • Configs

Editing a File

• Locate the file in the workspace.
• Click on the file name to open it.
• Make necessary edits and save your changes.

File Actions

Hover over any file or folder to access the Action Menu (⋮).

Action	Description
Download	Download the file or folder to your local machine
Delete	Permanently remove the file or folder. This action is irreversible — deleted files cannot be recovered.
Rename	Edit the file or folder name inline
Move	Relocate the item to another folder within the workspace. References in Jobs or Notebooks are not auto-updated — update paths manually after moving.
Copy	Create a duplicate in the target location
Edit	Open and modify the file directly in the text editor
Job	Create a new Job using the selected file as the source script. The file path is pre-populated in the Job configuration.
Copy Path	Copy the file or folder’s full workspace path to clipboard

note

You can only perform these actions on files only if you have required permission to access.

Download a file

1. Open the file action menu (⋮)
2. Click Download
3. File is saved locally in your default downloads folder

Download a folder

1. Open the file action menu (⋮)
2. Click Download
3. File is saved locally in zip format.

Rename

1. Select Rename from the action menu
2. Input the new name
3. Hit Enter or click ✓ to confirm

Move

1. Click Move
2. Choose the target folder using the provided navigation dialog
3. Confirm the move

Copy

1. Click Copy
2. Select destination folder
3. A duplicate of the file/folder is created

Edit

1. Click Edit from the action menu
2. The file opens in the text editor
3. Make your updates and save changes using Save or Ctrl + S

Job

1. Select Job from the action menu
2. The job config dialog appears with the selected file pre-attached
3. Configure job parameters and click Create

Copy Path

1. Click Copy Path from the action menu
2. The full workspace path is copied to your clipboard
3. Paste it wherever you need it

Benefits of file management in Workspaces

• Seamless integration — Files uploaded to a Workspace can be directly referenced in Job configurations and Notebook paths, so everything runs from a single location.
• Enhanced productivity — Edit scripts, review logs, and organize assets without leaving the Yeedu UI.
• Better organization — Folder structures and Git-synced repositories keep Workspace content structured and version-controlled.

note

The recommended resolution for Yeedu UI is 1920 × 1080.