skel

starter files for new garbash accounts
git clone git://git.garbash.com/alex/skel
Log | Files | Refs | README

commit edbbf7d2411c35a04e904d497c08f1031f61aa42
parent 319abb710528ebee494d68d5c5b59623f5fe5ea5
Author: alex <alex@garbash.com>
Date:   Mon, 15 Nov 2021 23:31:45 -0500

onboarding: Add ONBOARDING readme for new accounts

This is installed into /etc/skel/README.txt and emailed to
new users (as well as being in their home directory).

Diffstat:
AONBOARDING.txt | 109+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
1 file changed, 109 insertions(+), 0 deletions(-)

diff --git a/ONBOARDING.txt b/ONBOARDING.txt @@ -0,0 +1,109 @@ + . + '). + /;(( + .'____`. + | g | create + | a | something + | r | worth + | bash | rewriting + `-____-' + + +Welcome to garbash! + +While our invite-only nature means you probably have +a sysadmin on your speed-dial, we wanted to put together +a small collection of getting-started tips for you to +refer to as you take your first steps with your new +account! + +If you're new to OpenBSD or UNIX in general, a good +starting place is help(1) and intro(1). For the unfamiliar, +the name(N) syntax refers to a "man page" (manual page), +which can be accessed with the man(1) tool: + + $ man help + +Or, if there are multiple versions of the page (like intro): + + $ man intro 1 + +The 1 refers to the first section of the manual (7 is misc, +6 is games, you get the idea). + +Your new account has been provisioned with the following +services: + +1. A website + + All content in /var/www/htdocs/~user is served + on the world-wide-web at garbash.com/~user. + +2. An email address + + user@garbash.com is your new email address! + It can receive and send externally, but your + inbox can only be accessed on this machine + (for now). More on access below. You're also + subscribed to all 4 of our mailing lists: + dev@, announce@, misc@, and bugs@. They're a + great place to collaborate and discuss if + no one is on IRC. + + For access, we recommend using mutt(1), which + has already been configured to open your mailbox. + Just type `mutt` and read the UI for basic + keybindings! (arrows to navigate, enter to read) + +3. An IRC bouncer account + + IRC (Internet Relay Chat) is like Slack, but + retro. It can be accessed via a terminal client + like irssi(1) or our web client (irc.garbash.com). + For the web client you'll need to be on the VPN. + Your account is actually registered with our + bouncer, a program that keeps you connected and + maintains the backlog of messages when you're + offline. You don't need to worry about this with + the web client (it just works), but for irssi(1), + you'll want to connect to the bouncer! + + To get started quick, navigate to irc.garbash.com, + enter your username and password (in your email). + Once in, hit "Add network", choose: + + Hostname: irc.garbash.com + + Hit enter, and voila! Join #garbash and say hello! + +4. A VPN certificate + + A WireGuard VPN connection is necessary to + access certain internal-only resources, including + our web IRC client (irc.garbash.com) and our + mail archive (lists.garbash.com). The wg-quick(8) + file is in your inbox, and should only be used + on one device. If you need another cert, just + let an admin know! (~alex or ~anthony) + + On Linux/BSD, configure wireguard with just + + $ wg-quick up client.conf + + On macOS, you can paste the contents of client.conf + into the dropdown configuration tool. + +5. Git hosting + + You can publish your git repos by running the + newrepo(1) command. From there, clone the repo + or push an existing repo to it and updates will + be rendered on git.garbash.com (public!) + +--- + +Of course, if you have any questions, don't hesitate +to ask at misc@garbash.com or on #garbash on IRC! + +We hope you enjoy your stay! While you're here make +sure you create something worth rewriting :)