timewarp
/
coop-cloud-win-deploy
1
0
Fork 0
Code Issues Pull Requests Projects Releases 1 Wiki Activity
coop-cloud-win-deploy/01-CreateCapsul-and-Login/README.md

6.9 KiB
Raw Blame History

Create Coop-Cloud Capsul and Login Using SSH

Capsul is software by Cyberia Club for "small virtual machine (vm) as a service."

  1. Open https://yolo.servers.coop in your browser. Click on Login in the upper right corner. yolo home page

  2. Fill in your email address in the box. You will need to use this email address multiple times, so do not use a throw-away email address. Click the Log In button. yolo login page

  3. Open your email client and look for a new email with subject Click This Link to Login to Capsul and open the email. new email The email message contains an authorization link to your new account on yolo.servers.coop. Click the link, or copy and paste it into your browser's address bar. click link in email

  4. Back in your browser on the yolo servers website, click the SSH & API Keys link. There will be no front-end to your capsul. All access to it will be remote, for example, with ssh. You need to create SSH keys before you can create your capsul. open SSH & API Keys

  5. Create SSH Keys on your local Windows computer. This guide explains how to do so using Window's built-in OpenSSH feature. If you prefer PuTTY, you can skip these steps and use that instead.

    1. Open an Administrator PowerShell window. open administrator powershell on windows
    2. Use the get-WindowsCapability command to find out if Windows already has the OpenSSH client installed. is openssh client installed on windows? If you see "State : Installed" in the response, you don't need to add it. If it is not installed, use the Add-WindowsCapability command to add it. install openssh client on windows if needed
    3. Use the Windows command line:
      1. Open a cmd.exe window.
      2. cd to your home directory. In this example, the home directory is c:\users\userid.
      3. Use dir to discover if you already have a .ssh subdirectory in your home directory.
      4. If necessary, use mkdir .ssh to create the subdirectory.
      5. Run ssh-keygen.exe to generate an SSH key pair. Press enter key to accept the default filename. Press enter key twice to skip adding a passphrase. Your key pair identification is then saved in the .ssh subdirectory. You will see a key fingerprint ending in your-Windows-username@your-Windows-hostname. You'll also see the key's randomart image. create ssh key using ssh-keygen.exe
    4. Launch Notepad.exe and open file c:\users\userid\.ssh\id_rsa.pub. Select all of the file's contents and copy to the clipboard. copy public ssh key to clipboard using notepad.exe

  6. Return to the SSH PUBLIC KEYS page in your browser, find the box labeled File Contents and paste your public key from the clipboard into the box. Then, click the Upload button. paste public key into yolo SSH PUBLIC KEYS page

  7. Your uploaded public key will appear near the top of the page. your uploaded public key appears on yolo page

  8. Add funds to your account.

    1. Click the Account Balance link. The method used for payment is called Stripe.
    2. Click on the Add funds with the Credit/Debit (stripe) link. Fill in an amount in the box. For example, $20.
    3. Click on Pay with Stripe.
    4. Your browser will open the Stripe page. Fill in your email address and your card information. You have the option to save the information so you can pay faster next time.
    5. Click the Pay $20.00 button when done. Wait for it to verify your payment.
    6. Return to the Account Balance section and verify your ACCOUNT BALANCE

  9. Click the Capsuls link, and the Create one! link. This will open the CREATE CAPSUL page.

    1. You will see your account balance
    2. Pick a Capsul Size from the drop-down box. This screenshot shows size f1-xs selected.
    3. Leave Debian 10 (Buster) as the operating system; it's the only one available for Capsuls at this time.
    4. Put a check mark in the box next to the name of your public SSH key. In this screenshot, it's named user-name@host-name.
    5. Click on the Create button.
    6. Wait for your Capsul to be created and initialized. Create capsule

  10. Check out your new Capsul!

    1. Click the Capsul id link, which is capsul-fk46nit117 in this example. capsule created
    2. You'll see the details for your new Capsul. You will need two items from this page for later: the IPv4 Address (a.k.a. ip address) and the SSH HOST KEY FINGERPRINTS. capsule details
    3. It's recommended you copy the fingerprints into a plain text file; Notepad is fine for this: save capsul host fingerprints

  11. Remotely login to your new Capsul using ssh.

    1. Open a cmd.exe window
    2. Run ssh command. The name of the Linux user on the Capsul is user. You'll use the IPv4 address from a previous step.
    3. When you run the ssh command, you'll see a line saying the authenticity of the host can't be established. It will show you the key fingerprint.
    4. Use the mouse to copy the fingerprint string to the clipboard
    5. Open the Capsul fingerprints text file you saved in the previous step.
    6. Search for the key fingerprint by pasting it from the clipboard into the text editor's search query box. You should see that the fingerprint from the ssh command matches the fingerprint you saved when you created your Capsul.
    7. If it matches, enter "yes" in the command line window prompt "Are you sure you want to continue connecting". run ssh and match fingerprints
    8. You are now logged into your remote Capsule. first capsule login
    9. The default login shell for user is dash. If you prefer the bash shell, you can change it with the chsh command, as shown: change default shell to bash

Congratulations! You have created your remote Capsul and logged into it from your local Windows computer.