Home Directory

Your home directory is your own, private directory on the Uberspace host. It is a directory with the same name as your user account, stored within the /home directory. So if your Asteroid is named isabell, you home directory is /home/isabell.

Info

In many contexts, the tilde ~ can be used as a placeholder for your home directory. E.g. a path like ~/.ssh would become /home/isabell/.ssh.

What Should I Put Here?

The general rule is: Anything you don't want anyone else to see, especially any files you don't want to be accessible by the web server.

Default Files and Folders

~/.bash*

The .bash_profile, .bashrc and .bash_logout files are the configuration, startup and logout scripts for the Shell. .bash_profile is a script that is executed when you log in via SSH and will include .bashrc. If you want to run any commands automatically whenever you log in, add them to .bash_profile. .bash_logout is executed when you log out. After your first login, .bash_history will be added automatically and logs all you shell commands so you can re-run them later.

~/bin

Within the bin directory executables installed or written by yourself can be stored. They can then be called like normal commands.

~/bin and $PATH

Since ~/bin is very early on $PATH, executables placed here can shadow those from other places (e.g. installed by us). You can use this to install you own version of common tools and have them executed instead of the defaults.

~/.cache

A place for non-essential cached data, i.e. stuff you keep around, but can regenerate again if needed to. E.g. most package managers store their downloads here. This will not get cleaned up automatically! So if storage space gets tight, you can cleanup here. It's the default XDG_CACHE_HOME location.

~/.config

The .config folder is reserved for configuration files of any kind. It's the default XDG_CONFIG_HOME location.

~/.local/bin

Most package managers put installed binaries here, e.g. cargo, go, npm, pipx. Since this is on your $PATH by default, those can then be called like normal commands.

~/.local/share

The default XDG_DATA_HOME location.

~/.local/state

The default XDG_STATE_HOME location.

~/logs

A directory to store log files.

PHP Logs

For now PHP will log to ~/logs/php_error.log. This might change in the future, so that your PHP-FPM Service will log to your journal instead.

~/logs/webserver

We run some services for you, as part of our web stack. If you enable logs for those services (e.g. Caddy and Apache), they will end up here.

Alpha Logs

All logs are automatically enabled for the Alpha phase. Also we do not have a command for you to toggle this, yet.

~/.my.cnf

This is your MariaDB settings file.

~/.ssh

The .ssh directory contains your SSH configuration.

~/www

www is a symbolic link to your DocumentRoot. Anything in there is accessible to the web server, and thus to the public.