Workspaces

Workspaces are dedicated, isolated compute environments where you run your data science and machine learning workloads. Each workspace provides JupyterHub access with pre-configured libraries, persistent storage, and resources allocated based on your organization's subscription plan.

Overview

A workspace is your personal compute environment for running data science and machine learning workloads. Each workspace includes:

• JupyterHub interface for writing and running notebooks
• Compute resources (CPU, RAM, and GPUs based on your plan)
• Persistent storage that saves your work between sessions
• Pre-installed libraries for data science and machine learning
• Secure access controlled by your organization

Workspaces belong to an organization and inherit billing and access controls from it. You can create multiple workspaces to separate different projects, teams, or environments.

Workspace Lifecycle

Workspaces progress through several states during their lifecycle:

Created

Your workspace has been created but not yet deployed. You need to deploy it before you can start working.

Deploying

Your workspace is being set up. During this time, Eugo prepares:

• JupyterHub environment
• Compute resources
• Persistent storage for your notebooks
• Security and access controls

Deployed

Your workspace is ready to use. You can:

• Access JupyterHub and start working
• Create and run notebooks
• Install additional libraries
• Save data that persists between sessions

Deployed workspaces incur charges for compute and storage usage.

Suspending

Your workspace is being paused. All your work is preserved:

• Notebooks and data remain saved
• Workspace settings are retained
• Access permissions stay the same

Suspended

Your workspace is paused and temporarily inaccessible. This happens when:

• Payment issues need to be resolved
• An organization admin pauses the workspace
• Your organization runs out of credits

To resume access, resolve the underlying issue or contact your organization owner. All your notebooks and data remain saved while suspended.

Terminating

Your workspace is being permanently deleted, including:

• All notebooks and code
• Stored data and files
• Workspace configuration

Terminated

Your workspace has been permanently deleted. All notebooks and data are gone and cannot be recovered unless you backed them up before termination.

Failed States

If an operation fails, your workspace will show a failed state:

• Deploy Failed: Deployment didn't complete successfully. A Try again button appears to retry the deployment.
• Suspend Failed: Suspension didn't complete. The workspace may still be running and incurring charges.
• Terminate Failed: Deletion didn't complete. The workspace may still exist. You can retry termination from the actions menu.

If retrying doesn't resolve the issue, contact support for assistance.

How It Works

Creating a Workspace

Create a workspace to start running notebooks and code.

Before you start:

• You need an active organization membership
• Your role must include workspace creation permissions
• Your organization needs an active subscription
• A payment method must be set up

Steps:

1. Navigate to Workspaces in your organization
2. Click Create Workspace
3. Enter a descriptive workspace name
4. Click Create

Your workspace is now created but not yet deployed. Deploy it to start using it.

tip

Use descriptive workspace names that indicate the project, team, or environment (e.g., "Marketing Analytics - Production", "ML Model Training - Dev").

Deploying a Workspace

Deploy your workspace to make it ready for use.

1. Open your workspace from the Workspaces page
2. Click Deploy
3. Wait for deployment to complete

During deployment, Eugo sets up:

• Your JupyterHub environment
• Compute resources based on your plan
• Persistent storage for your work
• Pre-installed data science libraries
• Secure authentication

Once deployment completes, you can access your workspace and start working.

Accessing a Workspace

Once your workspace is deployed, open it to start working:

1. Navigate to the Workspaces page
2. Find your deployed workspace
3. Click Open EugoLab
4. Sign in when prompted

Your workspace opens in JupyterHub where you can create and run notebooks. All your work is automatically saved and available whenever you return to the workspace.

Downloading Notebooks

Export your notebooks for backup or to move them elsewhere:

1. Navigate to Workspaces
2. Select a deployed workspace
3. Click the actions menu (⋮)
4. Choose Download Notebooks

You'll receive a download link for a ZIP file containing all your notebooks. Download the file within 1 hour before the link expires.

Viewing Deployment History

See when your workspace was deployed and updated:

1. Navigate to Workspaces
2. Select a deployed workspace
3. Click Show Deployments

The deployment history shows:

• When each deployment occurred
• Deployment status (succeeded or failed)
• Which version was deployed
• Which plan was used
• How long it took

Review deployment history to troubleshoot issues or track changes to your workspace over time.

Terminating a Workspace

Permanently delete a workspace and all associated infrastructure.

warning

This action is irreversible. All notebooks, data, and configuration are permanently lost. Backup critical notebooks and data before terminating.

1. Navigate to Workspaces
2. Select the workspace to terminate
3. Click the actions menu (⋮)
4. Choose Terminate
5. Type DELETE to confirm
6. Click Terminate

Once the termination process is finished, the workspace is permanently removed.

Workspace Updates and Versions

Eugo releases regular platform updates with:

• Performance improvements
• Security patches and vulnerability fixes
• New features and library updates
• Bug fixes

You control when updates are applied to your workspaces. Updates are non-breaking and preserve all notebooks and data.

To update a workspace:

1. Check for available updates on the Workspaces page
2. Review release notes for the new version
3. Select the workspace to update
4. Click Update now or Upgrade now
5. Wait for the update to complete

Workspaces display a "New update available" message when updates are released. Schedule updates during low-activity periods to minimize disruption to active users.

Workspace Billing

Your workspace charges include:

• Platform fee: Base subscription cost from your plan
• Compute usage: Charges for CPU, RAM, and GPU resources you use
• Storage: Costs for EFS and S3 storage for notebooks and data
• EBS volumes: Block storage costs
• Other AWS services: Any additional services used by your workspace

Billing is calculated monthly for each workspace. You can see:

• Current month's accumulated costs
• Storage usage
• Detailed cost breakdowns

View complete billing details in the Billing section of your organization dashboard.

tip

Suspend or terminate unused workspaces to reduce costs. Suspended workspaces incur minimal storage fees while preserving all data.

Permissions

Your ability to work with workspaces depends on your role:

What you can do	Description
View workspaces	See the list of workspaces and their details
Create workspace	Create new workspaces
Deploy workspace	Deploy or update an existing workspace
Access workspace	Open and use JupyterHub
Terminate workspace	Permanently delete a workspace
Download notebooks	Export notebooks for backup

Your organization owner or admin assigns these permissions through roles. Contact them if you need different access.

Workspace Monitoring

Track your workspace activity and health through the Dashboard:

Organization Dashboard shows an overview of all workspaces:

• Total number of workspaces
• How many are active and accessible
• Suspended workspaces
• Workspaces with issues needing attention

Workspace Details shows information for individual workspaces:

• Current status and when it last changed
• Which version is deployed
• How much storage you're using
• Current month's costs

Activity Logs help you track what's happening:

• When workspaces are created, deployed, or terminated
• Who accessed which workspaces
• Configuration changes
• Errors or issues that occurred

Best Practices

Resource allocation — Match workspace plans to workload requirements. Use smaller plans for development and experimentation, larger plans with GPU support for production ML training.

Cost optimization — Suspend workspaces during extended periods of inactivity. Terminate workspaces that are no longer needed. Monitor storage usage and clean up unused datasets.

Environment separation — Create separate workspaces for development, staging, and production. This isolates environments and prevents accidental data or code mixing.

Backup strategy — Regularly download notebooks for critical projects. Consider syncing notebooks to version control (Git) or external storage.

Update management — Review release notes before applying updates. Test updates in non-production workspaces first. Schedule updates during maintenance windows.

Access control — Use role-based permissions to control who can access workspaces. Only grant creation permissions to users who need them. Limit deletion permissions to prevent accidental loss of work.

Naming conventions — Use consistent, descriptive workspace names that indicate purpose, team, and environment. Example: {team}-{project}-{env} like "data-analytics-staging".

Troubleshooting

Deployment Failed

Symptoms: Workspace stuck in DEPLOY_FAILED state after attempted deployment.

Solutions:

1. Retry the deployment by clicking Try again
2. Verify your organization has an active subscription and valid payment method
3. Review deployment logs in the deployment history for specific errors
4. Contact support if the issue persists after 2-3 retries

Cannot Access Workspace

Symptoms: Unable to open JupyterHub or receiving authentication errors.

Solutions:

1. Verify the workspace shows as deployed (not suspended or in another state)
2. Check with your admin that you have workspace access permissions
3. Confirm your user account is active in the organization
4. Clear your browser cookies and cache, then try again
5. Try accessing in an incognito/private browser window
6. If problems persist, contact your organization owner or support

Workspace Suspended

Symptoms: Workspace in SUSPENDED state, cannot access.

Solutions:

1. Check your organization's billing status and resolve any overdue payments
2. Verify your organization has sufficient credits (add more if needed)
3. Contact your organization owner to resume the workspace
4. Once the underlying issue is fixed, your workspace will become accessible again

Termination Failed

Symptoms: Workspace stuck in TERMINATE_FAILED state.

Solutions:

1. Retry termination from the workspace actions menu
2. Try again after some time if resources were temporarily locked
3. Check Activity Logs for specific error messages
4. Contact support if the workspace remains stuck after multiple retries

High Storage Usage

Symptoms: Workspace storage usage approaching or exceeding plan limits.

Solutions:

1. Open JupyterHub and delete notebooks or datasets you no longer need
2. Move large datasets to external storage
3. Download and archive old notebooks, then remove them from the workspace
4. Consider upgrading to a plan with more storage
5. Clean up temporary files and cached data regularly

Related Resources

• Dashboard — Monitor workspace metrics and organization overview
• Organizations — Manage organization settings and subscription plans
• Billing — Track costs and manage payment methods
• User Management — Assign roles and permissions for workspace access
• IDE — Learn about the JupyterHub environment and features
• Activity Logs — Audit workspace operations and user activity