Simon Marsh
7ba960307c
All checks were successful
continuous-integration/drone/push Build is passing
93 lines
3.0 KiB
Markdown
93 lines
3.0 KiB
Markdown
---
|
|
title: "Shell Accounts"
|
|
geekdocDescription: "burble.dn42 Shell Services"
|
|
weight: 60
|
|
---
|
|
burble.dn42 provides shell accounts on the following servers:
|
|
|
|
- shell.fr-rbx1.burble.dn42
|
|
|
|
## Accessing the Service
|
|
|
|
The shell service imports user information from the dn42 registry allowing
|
|
any MNTNER with an SSH auth method to log in to the servers. Usernames
|
|
are constructed by lowercasing and removing the '-MNT' suffix.
|
|
|
|
For example:
|
|
|
|
**FOO-MNT**
|
|
```
|
|
mntner: FOO-MNT
|
|
auth: ssh-ed25519 xxxxxxxxx
|
|
```
|
|
|
|
Log in using the key specified in the auth method:
|
|
```
|
|
ssh foo@shell.fr-rbx1.burble.dn42
|
|
```
|
|
|
|
Your home directory is created automatically on first access and will then
|
|
persist across logins.
|
|
|
|
## Key Services
|
|
|
|
### Installed Packages
|
|
|
|
A broad set of command line tools, applications and games are available;
|
|
the aim is to provide a comprehensive environment that is useful and
|
|
fun to tinker with.
|
|
|
|
The current set of packages can be found in the shell config repo:
|
|
|
|
- [https://git.dn42.dev/burble/config-shell/src/branch/main/roles/user_apps/tasks/main.yml](https://git.dn42.dev/burble/config-shell/src/branch/main/roles/user_apps/tasks/main.yml)
|
|
|
|
Requests for additional packages are welcome, please raise these as
|
|
[issues](https://git.dn42.dev/burble/config-shell/issues) in the repo.
|
|
|
|
### Scratch Area
|
|
|
|
A large storage area is mounted on to /scratch
|
|
|
|
/home disk space is limited, so /scratch may be used for additional space
|
|
or if you don't want to use /home. If you want to use the scratch
|
|
area it is recommended to create your own directory (named after your
|
|
username) and then store all your stuff in the new directory; this will help
|
|
prevent clutter.
|
|
|
|
Note that the storage for /scratch is nfs mounted across dn42 so
|
|
performance will be variable.
|
|
|
|
### Changing Shell
|
|
|
|
The registry import process currently limits the initial shell to /bin/bash
|
|
and currently this cannot be changed. If you want to use something different,
|
|
just exec to the new shell in your .profile or .bashrc.
|
|
|
|
### Clearnet
|
|
|
|
Clearnet access is provided. Rate limiting allows for a small amount of
|
|
burst traffic, but then bandwidth is quickly limited to 10mbit/sec. In general,
|
|
you should be better off using your own clearnet access for large downloads.
|
|
|
|
### Performance Monitoring
|
|
|
|
The shell servers are monitored using netdata and prometheus, with performance
|
|
graphs available in [grafana](https://grafana.burble.dn42).
|
|
|
|
## Acceptable Use
|
|
|
|
The objective of the burble.dn42 shell service is to provide a free, open,
|
|
and fun environment for dn42 users. The services are provided for your benefit so
|
|
please be considerate in your usage and remember that abusing the service just
|
|
spoils it for everyone else.
|
|
|
|
See also the main [Abuse Policy](/network/abuse).
|
|
|
|
## Source Code and Configuration
|
|
|
|
Configuration for the shell servers is maintained in a git repo:
|
|
|
|
- [https://git.dn42.dev/burble/config-shell](https://git.dn42.dev/burble/config-shell)
|
|
|
|
The repository may be used for raising issues or requesting additional
|
|
software to be installed. |