signup

signups for trash.town are done through a request for an account. in the request, you mention your preferred username, and your public SSH key.

page overview

• page conventions
• requirements
• generating your public and private ssh keys
• requesting an account

page conventions

• notes: signify additional information.
• tips: signify alternative procedures.
• warnings: signify that data loss, damage, or a security issue could occur.

requirements

a Unix-like environment with SSH, such as:

• ubuntu
• windows subsystem for linux
• macOS
• cygwin
• putty

generating your public and private ssh keys

public and private ssh keys allow you to log into trash.town through SSH. SSH will compare your private key on your computer to the public key on trash.town

without your public and private keys, you can't log into trash.town

to generate your public and private ssh keys

1. open your Unix-like environment
2. run ssh-keygen -b 4096 -t rsa -f ~/.ssh/trash.town
3. press enter if you don't need a password for accessing your key
4. press enter again to confirm

note: the command above generated two files:

• a private key at ~/.ssh/trash.town key (trash.town)
• a public key at ~/.ssh/trash.town.pub key (trash.town.pub)

note: don't share your private key with anyone. people can use your private and public keys to log into your account after you receive one, so it is important that you only share your public key when requesting an account

requesting an account

account requests work through email. you'll need to send an email with your public key and the username you want to trash.town.

the public key could be sent as an attachment, and your username could be included in the body text of the email, with information about why you want to join trash.town

to send your public ssh key to trash.town

1. run cat ~/.ssh/trash.town.pub
2. copy the output of text
3. paste the copied text into a .txt file
4. send an email with the username you want, and why you want to join trash.town, and your attached public key to signup@trash.town

tip: if you are having trouble with anything, you can check out tilde.town's SSH guide or tilde.town's key generator