Workspaces

You can create your first Workspace for accessing a cloud-based development environment ready to code, with the option to clone an existing git repository if you have one, the toolchains of your preference and your extras. Demeter allows you to set the workspace size depending on your Project needs, the network to connect, your workspace's name, the Git Author, the Git Email, and a token to be used for authentication.

Go to your project and in the Resources page, select the Add resource button. Then, click on the Deploy button inside the Workspace card. Once you have customized your development environment, select the Create button to start provisioning your workspace. Keep in mind that it is important to be connected to the Cardano Node of the same network of your project.

When it's ready, select the Open VS Code button to open the Dev console. You can also view Logs in real-time, change the size and network of your workspace and start it or pause it when you are done using it. On the same screen, you can choose your coding toolchain, add extra functionality to your workspace, expose ports, see the storage used by your workspace, add resources to your project and see a list of available environmental variables inside your workspace that can be used to access your connected extensions.

There is no limit to the number of Workspaces you can create or run in parallel under a Project. But keep in mind that each Workspace you have created will consume a considerable amount of DCUs. Always keep only the Workspaces you need to optimize your consumption. To learn more about the DCUs consumption, read our guide about DCUs.

Coding Stack

Select the set of tools and libraries to have pre-installed automatically in your Workspace:

Workspace Size

Git Author

Sets the git global configuration user.name

Git email

Sets the git global configuration user.email

Repository

If no repository is selected, we will generate an empty coding environment with the chosen tech stack, but if you have a Project with a dependency on Cardano infrastructure it's easy to integrate it with Demeter (opens in a new tab) to have it up and running in a Workspace in no time. Just include our CTA button in your Project for starting a Workspace with your repository code automatically cloned, providing a seamless experience for your users when running and trying your application.

Adding the button badge to your Readme

![Code in Workspace](https://demeter.run/code/badge.svg)

Setting the button link

(https://demeter.run/code?repository={YOUR REPOSITORY URL}&template={YOUR TECH STACK NAME}&size={YOUR WORKSPACES SIZE})

Available tech stacks

Available workspaces sizes

Example URL

(https://demeter.run/code?repository=https://github.com/txpipe/python-dbsync-starter-kit.git&template=python&size=small)

Launch a Jupyter Notebook Ready Workspace

To launch a Jupyter Notebook within your workspace, ensure you select the Jupyter Notebook VS Code Extension during the workspace configuration process. This option is available under the "Extras" section in the project console. By choosing this extension, you'll be able to work with Jupyter Notebooks directly in your workspace, leveraging the powerful features of VS Code and the ease of use of Jupyter Notebooks. This integration provides an ideal environment for data science, machine learning, and other computational tasks.

Delete a Workspace

To delete a workspace, just click on the Delete button from the Workspace detail screen.

Access resources from your Workspace

From inside your Workspace, you can access all the resources available in Demeter (opens in a new tab), i.e.: Cardano Node, DB-Sync, Ogmios, Kupo, Webhooks, etc. All pre-configured environment variables will be available according to the enabled extensions.

Working and making changes

Can I push my changes back to the git repository?

Yes, but you'll need to specify your git authentication credentials manually. By default, your workspace has the git remote origin pointing to the repository specified during creation. By running "git push origin", the git client will ask you for the corresponding credentials. The credentials to be used depend on the particular provider.

Do I lose my files when a Workspace restarts?

Most of your system personalizations. Anything outside the $HOME directory will NOT be persisted and effectively lost after your Workspace is paused.

DCUs Consumption

Demeter Compute Units (DCUs) are an abstraction layer implemented in Demeter (opens in a new tab) to measure infrastructure usage. Having a workspace running consumes several resources. To optimize resource consumption, make sure you always pause your workspace after completing your work, by clicking the pause button from the Workspace detail screen.

For the Workspaces paused, there is still a minimal amount of DCUs consumed per unit of time, given that all of your configuration and changes are persisted in the cloud. If you don't need a Workspace anymore, make sure you delete it from the list.

What happens if I leave my Workspace running?

Workspaces that are inactive after 30 minutes will be paused automatically. Regardless of the automatic pause, we recommend manually pausing your workspace right after you finish working to avoid wasting valuable resources.