diff --git a/content/services/public.md b/content/services/public.md
index e05cf36..d52774f 100644
--- a/content/services/public.md
+++ b/content/services/public.md
@@ -18,6 +18,15 @@ The public internet site is hosted on de-fra1 behind
 [CloudFlare](https://www.cloudflare.com) and the source for the website
 is [published](https://git.burble.com/burble.dn42/www) in the burble.dn42 git.
 
+## Service Administration Portal
+
+- [svc.burble.dn42](https://svc.burble.dn42/)
+
+The service portal allows you to configure your burble.dn42 services.
+
+The main function of the portal is to set a burble.dn42 password
+for gaining access to other services.
+
 ## Issue Log
 
 A public issue log is maintained on the [DN42 Registry](https://git.dn42.dev).
diff --git a/content/services/shell.md b/content/services/shell.md
index f2e8be6..5d238b6 100644
--- a/content/services/shell.md
+++ b/content/services/shell.md
@@ -12,8 +12,19 @@ burble.dn42 provides shell accounts on the following servers:
 ## 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.
+any MNTNER to log in to the servers. Usernames are constructed by
+lowercasing and removing the '-MNT' suffix.
+
+### Using an SSH public key
+
+If you have an `auth` attribute with an SSH public key, this will be
+imported from the registry and you can use the SSH key to log in to the
+shell server.
+
+### Using a password
+
+MNTNERs without an SSH key must first use the
+[burble.dn42 service portal](https://svc.burble.dn42) to set an account password.
 
 {{<hint info>}}
 **FOO-MNT**
@@ -22,7 +33,8 @@ mntner:             FOO-MNT
 auth:               ssh-ed25519 xxxxxxxxx
 ```
 
-Log in using the key specified in the auth method:
+Log in using your ssh key or burble.dn42 password:
+
 ```shell
 ssh foo@shell.fr-rbx1.burble.dn42
 ```
@@ -96,19 +108,10 @@ Note that the storage for /scratch is nfs mounted across dn42 so
 performance will be variable.
 {{</hint>}}
 
-### Changing Shell
+### Login 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.
-
-{{<hint info>}}
-Example .bashrc line for zsh:
-
-```shell
-if [[ $- == *i* ]]; then exec /usr/bin/zsh; fi
-```
-{{</hint>}}
+You can change your login shell using the
+[burble.dn42 service portal](https://svc.burble.dn42).
 
 ### Cron, Batch and Services
 
@@ -137,10 +140,11 @@ The netdata dashboard is also directly accessible:
 
 ## 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.
+In general, as long as you are not risking the service or other users you
+should be ok. These services are provided free for your benefit, and the
+objective is to provide a fun, open environment for dn42 users.
+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).