From 10c71a13e14debb9511dcf875b3555fd5f688eb3 Mon Sep 17 00:00:00 2001 From: Eric Bower Date: Wed, 15 May 2024 11:09:22 -0400 Subject: [PATCH] docs: copy --- main.go | 7 ++++--- posts/faq.md | 44 ++++++++++++++++++++++++++++++++-------- posts/getting-started.md | 4 ++-- 3 files changed, 41 insertions(+), 14 deletions(-) diff --git a/main.go b/main.go index 7436a8f..f85f53b 100644 --- a/main.go +++ b/main.go @@ -176,14 +176,15 @@ func main() { Page: pager("faq.md"), Tag: "Help", Children: []*pdocs.Sitemap{ - pdocs.AnchorTagSitemap("Permission denied when using SSH"), + pdocs.AnchorTagSitemap("Why can't I login to pico"), pdocs.AnchorTagSitemap("How do I force the correct pico SSH key"), - pdocs.AnchorTagSitemap("Generating a new SSH key"), - pdocs.AnchorTagSitemap("Why do I provide my username when using SSH"), + pdocs.AnchorTagSitemap("How do I generate an SSH key"), + pdocs.AnchorTagSitemap("How can I setup my ssh-agent"), pdocs.AnchorTagSitemap("How can I use git to sync my content"), pdocs.AnchorTagSitemap("Can I create multiple pico accounts"), pdocs.AnchorTagSitemap("Can I associate multiple SSH keypairs to a single account"), pdocs.AnchorTagSitemap("Are there any bandwidth limitations"), + pdocs.AnchorTagSitemap("How can I download a copy of all of my content"), pdocs.AnchorTagSitemap("How can I delete my content"), pdocs.AnchorTagSitemap("How can I delete my account with my content"), pdocs.AnchorTagSitemap("I lost my SSH private key how can I recover my account"), diff --git a/posts/faq.md b/posts/faq.md index efd2421..30cebc3 100644 --- a/posts/faq.md +++ b/posts/faq.md @@ -5,11 +5,11 @@ keywords: [pico, faq, question, answer] toc: 1 --- -# Permission denied when using SSH +# Why can't I login to pico? There are a couple reason why this might be happening. We require a public key -for authentication to all of our services, so first make sure you have a valid -SSH keypair. +for authentication to all of our services, so first we need to make sure you +have a valid SSH keypair and it is being sent to our SSH server. Not sure what type of keys you have? You can check with the following: @@ -17,15 +17,25 @@ Not sure what type of keys you have? You can check with the following: find ~/.ssh/id_*.pub -exec ssh-keygen -l -f {} \; ``` -After that we need to determine why our server is rejecting your public key. -What is most helpful is if you run: +After that we need to determine why our server is not receiving your pubkey. To +start, trying debugging with: ```bash ssh -vvv pico.sh ``` -If you cannot figure out what is wrong just by looking at that output, then you -are more than welcome to join [irc](/irc) and send us a paste of the SSH logs. +Here we are looking for the pubkeys that your SSH client is sending to us. + +For example, we want to see something like: + +```bash +debug1: Will attempt key: /home/myuser/.ssh/id_ed25519 ED25519 SHA256:XXX agent +debug1: Offering public key: /home/myuser/.ssh/id_ed25519 ED25519 SHA256:XXX agent +debug1: Server accepts key: /home/myuser/.ssh/id_ed25519 ED25519 SHA256:XXX agent +``` + +If you don't see any of these log statement, it probably means you haven't +loaded your SSH keys into your [SSH agent](#how-can-i-setup-my-ssh-agent). You should also make sure you have the correct file permissions set for your ssh folder and keys: @@ -36,6 +46,9 @@ chmod 644 ~/.ssh/id_ed25519.pub chmod 600 ~/.ssh/id_ed25519 ``` +If you cannot figure out what is wrong just by looking at that output, then you +are more than welcome to join [irc](/irc) and send us a paste of the SSH logs. + # How do I force the correct pico SSH key? There are two ways, one is when SSHing to us: @@ -52,7 +65,7 @@ Host pico.sh pgs.sh prose.sh IdentityFile ~/.ssh/id_ed25519 ``` -# Generating a new SSH key +# How do I generate an SSH key? [Github Reference](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent) @@ -63,6 +76,14 @@ ssh-keygen -t ed25519 -C "your_email@example.com" When you're prompted to "Enter a file in which to save the key," press Enter. This accepts the default file location. At the prompt, type a secure passphrase. +# How can I setup my `ssh-agent`? + +your SSH agent typically hosts your SSH keypairs and serves them when +authenticating with an SSH server. So, ensuring your `ssh-agent` is setup +properly is important when connecting to us. + +[Github has a great guide on this.](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent#adding-your-ssh-key-to-the-ssh-agent) + # How can I use `git` to sync my content? All you need is your private key and @@ -100,6 +121,11 @@ So until we reach 10TB per month, there are no bandwidth limitations. Once we regularly reach our monthly allowance, we will have to re-evaluate our pricing structure. +# How can I download a copy of all of my content? + +We will provide users with their data if they request it via +[email](mailto:hello@pico.sh). + # How can I delete my content? [File uploads](/file-uploads#how-do-i-delete-files) @@ -115,7 +141,7 @@ ssh pico.sh # Confirm delete your account ``` -# I lost my SSH private key how can I recover my account? +# I lost my SSH private key, how can I recover my account? After account creation, we **highly** recommend users generate an [API Token](/api-token) and store that someplace safe. If you lose your SSH diff --git a/posts/getting-started.md b/posts/getting-started.md index b3fef29..1a00cab 100644 --- a/posts/getting-started.md +++ b/posts/getting-started.md @@ -19,8 +19,8 @@ To get started, simply use SSH: ssh pico.sh ``` -Getting `Permission denied (publickey)`? -[Read how to fix it here](faq#permission-denied-when-using-ssh). +Getting an error? Read our FAQ, +[why can't I login to pico?](faq#why-cant-i-login-to-pico). All we need to create an account is your username. This username will be used for all of your service domains. For example, if your username is `glossy`, we