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 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:

1find ~/.ssh/id_*.pub -exec ssh-keygen -l -f {} \;

After that we need to determine why our server is not receiving your pubkey. To start, trying debugging with:

1ssh -vvv pico.sh

Here we are looking for the pubkeys that your SSH client is sending to us.

For example, we want to see something like:

1debug1: Will attempt key: /home/myuser/.ssh/id_ed25519 ED25519 SHA256:XXX agent
2debug1: Offering public key: /home/myuser/.ssh/id_ed25519 ED25519 SHA256:XXX agent
3debug1: 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.

You should also make sure you have the correct file permissions set for your ssh folder and keys:

1chmod 700 ~/.ssh
2chmod 644 ~/.ssh/id_ed25519.pub
3chmod 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 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:

1ssh -o IdentitiesOnly=yes -i ~/.ssh/id_ed25519 pico.sh

The other is with an SSH config entry (~/.ssh/config):

1Host pico.sh pgs.sh prose.sh tuns.sh
2  IdentitiesOnly yes
3  IdentityFile ~/.ssh/id_ed25519

How do I generate an SSH key? #

GitHub Reference

1ssh-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.

How can I use git to sync my content? #

All you need is your private key and one of the upload tools we support

For example, here is how we deploy the pico blog

Can I create multiple pico accounts? #

Yes! The only requirement is that SSH keypairs added to our system must be unique across all users. So you cannot have the same pubkey across multiple pico accounts.

Other than that, you are welcome to create multiple pico accounts. Just keep in mind that each pico+ membership is assigned to a single account.

Can I associate multiple SSH keypairs to a single account? #

Yes! There are two ways to manage SSH keys:

authorized_keys file #

We have an API for syncing authorized_keys. This file is bidirectional, meaning you can download and upload and we will diff and patch your authorized pubkeys on the pico platform.

1rsync pico.sh:/authorized_keys .
2# edit keys (add, remove, edit comments)
3rsync ./authorized_keys pico.sh

Caveat: as a safety precaution, we will never remove the pubkey currently being used.

For example, if you want to sync your github pubkeys with us:

1curl https://github.com/neurosnap.keys > ./authorized_keys
2scp ./authorized_keys pico.sh:/

tui #

1ssh pico.sh
2# => Manage Keys
3# Press "n" to add a new pubkey

Are there any bandwidth limitations? #

Currently we are not hitting our free egress limit per month through our cloud provider. As of 9/2024 we are at around 500GB.

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.

How can I delete my content? #

File uploads

How can I delete my account with my content? #

You are able to delete your account yourself, but it is a little hidden.

1ssh pico.sh
2# select "Manage keys"
3# Delete all of your keys
4# Confirm delete your account

I lost my SSH private key, how can I recover my account? #

After account creation, we highly recommend users generate an API Token and store that someplace safe. If you lose your SSH private key and contact us, we can use that API token to confirm you own the pico account and manually recover it for you.