site/wiki/pages/administration.md

97 lines
2.7 KiB
Markdown
Raw Normal View History

2018-06-10 01:16:31 +00:00
---
author: ~ben
published: false
title: administration
description: ~team admin guide
2018-08-03 04:53:24 +00:00
category:
2018-06-10 01:16:31 +00:00
- main
---
# administration
---
## adding users
2018-08-03 04:53:24 +00:00
1. generate a random password (12-20 characters, no spaces)
2018-06-10 01:16:31 +00:00
1. create a new user account:
```bash
sudo adduser newusername
```
2018-08-03 04:53:24 +00:00
1. add their ssh pubkey:
```bash
echo "ssh pubkey from their signup email" | sudo tee /home/newusername/.ssh/authorized_keys
```
2018-06-10 01:16:31 +00:00
2018-08-03 04:53:24 +00:00
1. drop the requested username and generated password in the placeholder below. reply all so that other admins will know that it's been handled.
2018-07-23 07:24:54 +00:00
2018-07-06 13:14:06 +00:00
welcome mail template:
```
2018-08-03 04:53:24 +00:00
hey ~newusername,
2018-07-06 13:14:06 +00:00
welcome to tilde.team!
2018-08-03 04:53:24 +00:00
your new account has been established. you can ssh into tilde.team with
2018-07-06 13:14:06 +00:00
the ssh key you supplied on registration.
2018-07-23 07:24:54 +00:00
your password is "[[password]]". please change it when you log in for
2018-08-03 04:53:24 +00:00
the first time. the password is used for imap/smtp auth, not shell login,
which is set to only use ssh key authentication.
2018-07-06 13:14:06 +00:00
2018-08-03 04:53:24 +00:00
to get started, type `motd` at the command prompt to see a few ways to
2018-07-06 13:14:06 +00:00
get started. have fun!
2018-08-03 04:53:24 +00:00
the greatest value of tilde.team is not the services provided by the
server, but rather the interesting and welcoming community built by its
users. this is possible because of people like you who choose to make
this a great place. the best way you can help tilde.team is by working
to support a great system culture. chat on irc; build cool programs and
share them with others; focus on learning, and help others learn; be a
2018-07-06 13:14:06 +00:00
good example for others; have fun!
2018-08-03 04:53:24 +00:00
also, your ~/public_html directory is served at
https://tilde.team/~newusername/
(you can also use https://newusername.tilde.team)
2018-07-06 13:14:06 +00:00
2018-08-03 04:53:24 +00:00
check out our wiki at https://tilde.team/wiki/ for more information (and
2018-07-06 13:14:06 +00:00
maybe help us write a new wiki article:)
2018-08-03 04:53:24 +00:00
our irc is tilde.chat, an irc network connecting several
tilde servers. the `chat` command on your ~team shell will open up
weechat with some nice default configs and plugins.
see our wiki article (https://tilde.team/wiki/?page=irc)
or https://tilde.chat site for information on how to connect from elsewhere.
we also have a webclient at https://irc.tilde.team that you can
register for by running the `webirc` command from a shell session.
2018-07-06 13:14:06 +00:00
we look forward to seeing you around! welcome to the ~team!
~tilde.team admins
```
2018-06-10 01:16:31 +00:00
2018-06-11 01:37:24 +00:00
2018-06-10 01:16:31 +00:00
---
## backups
tilde.team uses [tarsnap](https://tarsnap.com) for backups and is configured to save 12 hourly backups, 7 daily backups, 6 weekly backups, and 2 years' worth of monthly backups.
to see a list of the backups:
```bash
sudo tarsnap --list-archives
```
to restore a backup:
```bash
2018-06-11 01:37:24 +00:00
tarsnap -x -f name-of-backup
2018-06-10 01:16:31 +00:00
```
we keep backups of:
* `/home`
* `/etc`
* `/var` (excluding `/var/log`)
see the [tarsnap documentation](https://www.tarsnap.com/usage.html) for more information.