🐥Getting started

How to setup your first workstation

Congrats, you just received your new workstation! 🎉

Let's go together through the different steps to be able to edit code and see the changes on your platform.

This page is intended for a developer and will describe the first steps for someone who plans on writing code. If this is not your case, you are probably not on the right page :)

0 - Find your Remote Workstation configuration

​Open the production backoffice, and in the header menu click on "Remote Workstations".

List Remote Workstations created for your user

Click on the line of your Remote Workstation and you will see your current configuration.

You need 3 information:

  • the status of your Remote Workstation (Ready, Stopped, Updating, etc...)

  • the link to the backoffice

  • the command line to connect to the sandbox

For this guide, here are some fake examples:

1 - Start your Remote Workstation

To avoid using unnecessary resources, your Remote Workstation is stopped. When you start working on it, you can start it from the production backoffice.

This way it is running only when needed 🌿

If the state of your Remote Workstation is "Stopped", you will need to start it before being able to work on it. This should take less than 3 minutes.

You will need to refresh the page and wait for the state to be "Ready"

2 - Check you have access to Testeur

Open your backoffice link, and check you have to Testeur. The link should look like this, with my-alias replaced by the alias to your workstation:

https://tc.my-alias.tc.exo7d.us

3 - Check you can connect to the sandbox

Open your Terminal, and enter the command line provided in the Remote Workstation configuration

It should look like this, with my-alias replaced by the alias to your workstation

ssh user@my-alias.tc.exo7d.us -p 2222 -A

4 - Clone your first theme

Now that you are inside your sandbox, go to the folder integration, that will contain all your themes

cd integration

And now you can git clone your theme 

git clone XXXXXXX

And finally, in Testeur your theme should be here, you can click on "Update theme" to add it to the platform

5 - Import your first Account

When a new workstation is created, it doesn't have any websites.

Now that you have added the first theme, you can start importing websites.

🌟Import websites

6 - Editing code

Many IDEs will provide you with a way to connect remotely with SSH.

At xo7, we use Visual Studio Code, find here our page dedicated to your setup:

VSC Remote - SSH extension

  • In case you need to work with a specific version of Node NVM is available. Read more here: NVM - Node Version Manager

  • Your new workstation has no git configuration, don't forget to add your email and username. Read more here: Git configuration

Now that you know the basics about your Remote Workstations, feel free to deep dive in other topics:

📚Essentials💻Developers
PreviousIntroductionNextEssentials

Last updated