diff --git a/md/add-traefik-deploy.md b/md/add-traefik-deploy.md index 3f1c416..1f4e2ce 100644 --- a/md/add-traefik-deploy.md +++ b/md/add-traefik-deploy.md @@ -1,5 +1,5 @@ # Add the Traefik App to Your Capsul: -1. Add app to server +1. Add the Traefik app to the server ![Add traefik app to server](../res/traefik/03.png "Add traefik app to server") 2. Open Traefik's configuration file: diff --git a/md/create-acct.md b/md/create-acct.md index 3d47d5e..573a582 100644 --- a/md/create-acct.md +++ b/md/create-acct.md @@ -11,6 +11,6 @@ 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](../res/coop-cloud-acct/05-email-click-this.png "click link in email message") -When the browser opens a page with your email address in the upper right corner, you have created an account with yolol.servers.coop. +When the browser opens a page with your email address in the upper right corner, you have created an account with yolo.servers.coop. | [Next](upload-pub-key.md) | [Top](../README.md) | diff --git a/md/inst-docker-on-capsul.md b/md/inst-docker-on-capsul.md index f1497e0..1dd85a2 100644 --- a/md/inst-docker-on-capsul.md +++ b/md/inst-docker-on-capsul.md @@ -9,10 +9,16 @@ # Add *user* to the *docker* Group -After installing docker on your capsule, use *sudo usermod* command to add *user* to the *docker* group. Be sure to logout for this change to take effect. When you ssh back into the capsul, the *id* command shows which groups *user* is in. +After installing docker on your capsule, use *sudo usermod* command to add *user* to the *docker* group. + +![13](../res/install-docker-capsul/13.png) + +Be sure to logout for this change to take effect. - ![13](../res/install-docker-capsul/13.png) ![14](../res/install-docker-capsul/14.png) + +When you ssh back into the capsul, the *id* command shows which groups *user* is in. + ![15](../res/install-docker-capsul/15.png) After installing docker on the capsule and confirming that *user* is in the *docker* group, continue to the next step. diff --git a/md/inst-wsl2-linux.md b/md/inst-wsl2-linux.md index 9c3a129..bdc1fab 100644 --- a/md/inst-wsl2-linux.md +++ b/md/inst-wsl2-linux.md @@ -22,7 +22,7 @@ If you live your computing life on the bleeding edge, you can get a preview of W ## Lets Do It!!! Without further ado, let's get WSL2 installed on Windows 10! This guide is following the instructions from this page: [Windows Subsystem for Linux Installation Guide for Windows 10](https://docs.microsoft.com/en-us/windows/wsl/install-win10) -There are two options available for install, simplified and manual. This guide goes through the six manual steps. **Note:** If you run into problems, there's a [troubleshooting](https://docs.microsoft.com/en-us/windows/wsl/install-win10#troubleshooting-installation) section at the bottom of the page. ![01](../res/install-wsl2-linux/01.png "01") +There are two options available for install, simplified and manual. This guide goes through the six manual steps. **Note:** If you run into problems, there's a [troubleshooting](https://docs.microsoft.com/en-us/windows/wsl/install-win10#troubleshooting-installation) section at the bottom of the Microsoft WSL installation page. ![01](../res/install-wsl2-linux/01.png "01") 1. The first step (of six) is to enable the "Windows Subsystem for Linux" feature, aka the Microsoft-Windows-Subsystem-Linux feature. Open an Administrator PowerShell window and run the dism.exe command as shown. Do **NOT** restart your computer yet. @@ -80,12 +80,14 @@ After saving the .msi file to disk, find the downloaded file in File Explorer. D > wsl --list --online ![18](../res/install-wsl2-linux/18.png "18") + Pick which Linux distribution you want to install, and either click one of the links on Microsoft's web page, or do a search in the Microsoft Store. When you've found your distro in the store, you first need to click the *Get* button and then the *Launch* button. If you see a popup window like this, you can close it. You don't need a Windows account to get and install Linux distros from the Microsoft Store. ![19](../res/install-wsl2-linux/19.png "19") + Here's the Debian distro in the store. I've already gotten it once before, so I don't see the *Get* button. I just need to install and launch it.: ![20](../res/install-wsl2-linux/20.png "20") ![21](../res/install-wsl2-linux/21.png "21") diff --git a/md/setup-dns.md b/md/setup-dns.md index d93adbe..86c25fe 100644 --- a/md/setup-dns.md +++ b/md/setup-dns.md @@ -1,3 +1,5 @@ +# Connect a Domain Name with Capsul's IP-Address + Your Capsul needs a hostname, also known as a domain name. There are many services which provide domain names, such as [Gandi](https://www.gandi.net) and many more. You need to register a domain name, and then set up DNS records to connect your domain name with the IPv4 address assigned to your Capsul when you created it. Each domain registrar has a different user interface for managing DNS records. Set up three 'A' records. One for the domain itself, one for www.your-domain-name, and one for subdomains of the domain. It will look something like this: diff --git a/md/setup-server.md b/md/setup-server.md index 67e5938..69fecea 100644 --- a/md/setup-server.md +++ b/md/setup-server.md @@ -4,13 +4,13 @@ First, add your server to abra. Change *your-domain-name* to your capsul's DNS n > abra server add your-domain-name user -![Add server to Abra](..\res\create-init-context\01.png "Add server to Abra") +![Add server to Abra](../res/create-init-context\01.png "Add server to Abra") Next, after creating the server, initialize the docker swarm. > abra server your-domain-name init -![Initialize docker swarm for server](..\res\create-init-context\02.png "Initialize docker swarm for server") +![Initialize docker swarm for server](../res/create-init-context\02.png "Initialize docker swarm for server") The next step is to install Traefik. diff --git a/md/ssh-to-capsul-from-wsl.md b/md/ssh-to-capsul-from-wsl.md index 7c19474..05c27f4 100644 --- a/md/ssh-to-capsul-from-wsl.md +++ b/md/ssh-to-capsul-from-wsl.md @@ -9,9 +9,10 @@ Previously, we logged into the remote capsule using ssh in a Windows cmd.exe win > cd ~/.ssh -1. Copy your keys from your Windows .ssh directory into the Linux .ssh directory using the cp command and the Windows C: drive being mounted at /mnt/c. Assuming your Windows user name is *user*. Verify that both parts of your key have been copied into the Linux ~/.ssh folder with the *ls* command. +1. Copy your keys from your Windows .ssh directory into the Linux .ssh directory using the cp command. In the Linux Debian system, /mnt/c corresponds to c:\ in the Windows system. Let's assume your Windows user name is *user*. Use *ls* command to verify that both parts of your key have been copied into the Linux ~/.ssh folder. - > cp /mnt/c/users/user/.ssh/id_rsa* . + > cp /mnt/c/users/user/.ssh/id_rsa* . + > ls ~/.ssh You should see two files, id_rsa and id_rsa.pub @@ -41,7 +42,7 @@ Previously, we logged into the remote capsule using ssh in a Windows cmd.exe win > ssh user@capsul-domain-name ![run ssh again using domain name instead of ip address](../res/wsl-ssh-to-capsul/05.png "run ssh again using domain name instead of ip address") -1. Again, compare the fingerprint of the ssh command with the fingerprint in the capsul-fingerprints file. If they match, type *yes* and Enter. This causes the domain name to be added to the list of known hosts. +1. Again, compare the fingerprint of the ssh command with the fingerprint in the capsul-fingerprints file. If they match, type *yes* and Enter. This causes the domain name to be added to the list of known hosts in Linux. 1. Close the ssh connection to your remote capsule. diff --git a/md/upload-pub-key.md b/md/upload-pub-key.md index 6ebe9a9..26b94cb 100644 --- a/md/upload-pub-key.md +++ b/md/upload-pub-key.md @@ -2,7 +2,7 @@ There is no front-end to your capsul. All access to it will be remote, for example, with *ssh*. You need to create SSH keys and upload your public key to your account before you can create a capsul. -This guide explains how to create SSH Keys on your local Windows computer. The steps describe using Window's built-in OpenSSH feature. If you prefer [PuTTY](https://en.wikipedia.org/wiki/PuTTY), you can skip these steps and use that instead. +This guide explains how to create SSH Keys on your local Windows computer. The steps describe using Window's built-in OpenSSH feature. If you prefer [PuTTY](https://en.wikipedia.org/wiki/PuTTY), you can skip to step 5. 1. Open an Administrator PowerShell window. ![open administrator powershell on windows](../res/upload-pub-key/08-win-admin-power-shell.png)