Actions
Manage your instance lifecycle and configuration through these available actions:
Launch App
The Launch App action opens the application interface running on your instance directly in the browser, such as a Jupyter notebook, or any other service exposed on your instance.
Stop
The Stop action shuts down your instance and releases its compute resources. Your saved data and configurations are preserved and will be available when you start the instance again.
When to Use
- When you no longer need the instance running temporarily and want to free up compute resources.
- When you want to pause billing for compute without deleting the instance or its data.
How to Stop
- Navigate to your instance and click Stop from the Actions menu.
- Confirm the action when prompted.
- Only hourly instances can be stopped.
- Billing Note: Stopping an instance pauses compute billing but does not stop billing for the workspace disk. Disk charges continue until the instance is deleted.
- Files saved within
/home/jovyanwill be preserved. However, any packages manually installed during the session will need to be reinstalled when the instance is started again.
Start
The Start action resumes your instance by allocating compute resources and re-establishing the connection to the workspace. It is the opposite of the Stop action.
When to Use
- When you have stopped your instance and want to resume work.
How to Start
- Navigate to your stopped instance and click Start from the Actions menu.
- Confirm the action when prompted.
Restart Instance
The Restart action refreshes your instance while preserving your saved data and configurations. It clears the current session and applies any updated settings.
When to Use
- When the instance is unresponsive or experiencing performance issues.
- After making system-level configuration changes that require a reboot.
- When start scripts need to be re-executed.
- When you need a fresh session without losing your saved work.
How to Restart
- Navigate to your instance and click Restart from the Actions menu.
- Confirm the restart when prompted.
Files saved within
/home/jovyanwill be preserved after the restart. However, any packages manually installed during the session will need to be reinstalled after the instance restarts.
An instance can be started, stopped, or restarted using the same API endpoint. Refer to the Instance Actions API documentation for request parameters and examples.