/ Getting Started

Creating a Machine in Ronin

Creating a machine is easy in Ronin, we take care of all the tricky bits.

Lets get started

Step 1 - Select "New Machine" in the sidebar.

New Machine

This will take you to the create machine page.

Screenshot-20180228121858-1212x939-1

In the top section of the Software tab, you have a choice from all the latest operating systems.

Screenshot-20180301095429-1027x307

In the bottom section of the 1. SOFTWARE tab, a list of pre-configured software for a quicker start.

Screenshot-20180301095515-1028x305

There is also a section where you can choose from your project's pre-configured software, called Packages.

Screenshot-20180301095605-336x128

For more on packages - click here

Step 2 - Select an operating system, pre-configured package or a project package.

For this example, we'll pick an Ubuntu machine.

Screenshot-20180301122124-1420x878

You can now move on to the next tab - 2. ADDRESS.

Step 3 - Give your machine a web address.

Screen-Shot-2018-02-17-at-9.36.38-pm

Once you stop typing, Ronin will check if this is available, and you will then be able to SELECT this address.

For this example, we are addressing this machine my-machine (imaginative, I know!). When we launch this machine, the full address it will be accessible from is my-machine.ronin.cloud

This will take care of all the networking internally and externally... you're welcome :)

You can also name your machine and give it a description, for extra visibility.

Screenshot-20180301103221-1009x303

You can now move onto the next tab - 3. MACHINE TYPE

Step 4 - Pick a machine size.

For this example, we will pick Medium size

Screenshot-20180301103608-1029x365

Don't worry about getting this wrong. It's incredibly easy to change the type of machine later if your needs change.

If you're looking for a particular machine, in the bottom section of the 3. MACHINE TYPE section is the Advanced options. Click on one to expand, and choose from the various types of machines.

Screenshot-20180301103927-1021x367-1

Once selected, you can move onto the next tab 4. STORAGE

Step 5. (Optional) - Add additional storage.

Screen-Shot-2018-02-17-at-9.41.18-pm

Again, Ronin provides you with the most popular choices. For this example, we have chosen "Small" which is 100GB on a Solid State Drive.

You will notice in the Machine Summary card two volumes, the Root Volume, and the 100GB SSD we just added.

The Root Volume is where your Operating System gets installed. You can increase the size of this by clicking the next to the volume shown here.

Screenshot-20180301111046-436x283

For more info on storage here

Step 6 - Click the Launch Button!

Once you're happy with your machine selection, select the green launch button on the machine card.

The Launch Machine modal will now appear.

Step 7 - Secure your machine

For Linux based machines, you will need to create a secure key to connect to your machine via SSH.

For Windows based machines, you will be able to set a password for your machine of your choice to connect via RDP.

For this Ubuntu example (Linux Based), we will need to create a secure key.

SUPER IMPORTANT WARNING BEFORE YOU START!!!
SSH keys work similar to real world keys, so whoever has a copy of your key has full access to your machine, so be really careful where you store it and who you give it to!

Select the Create tab, name your key and select GENERATE A NEW SSH KEY.

Ronin will download your key to your "Downloads" folder.

You will need this key to connect to your machine, more on that later.

Click GOT IT! LET'S CONTINUE

Step 8 - Launch your machine

Your newly created key will be selected and you are now ready to launch your machine! Select the LAUNCH MY MACHINE button.

Hooray!! Your machine is being launched. Click the SHOW ME MY NEW MACHINE button to see your new machine!

It may take a minute or two for your machine to be ready, so hang in there.

Screenshot-20180228121248-1128x940

Once your machine is up and running, we can now connect to it!

Next Steps

Connecting to your new machine

SUBSCRIBE