Setting up a Debian base-system (with Hyper-V notes)

Contents

For most of my Linux projects, and a lot of the tutorials on this site, I fire up a virtual machine on Hyper-V and load a minimal Debian system. Working with a Debian system gives me a stable, clean, platform I can easily customize as needed. If you were interested in a similar setup, here’s a walkthrough.

Working on Debian allows me to use a popular platform that isn’t overly bloated and allows me to generalize my set up to a wide array of *-nix type systems. The beginning of this article is based around deploying Debian as a virtual-machine (VM) in a Hyper-V environment but the rest of it applies no matter if you’re using a VM on a different host or a bare-metal setup. If you want to skip most of the Hyper-V related stuff, click here. There are the odd references to Hyper-V throughout the other sections, but you can safely ignore those if you’re not using Hyper-V.

Host platform

I personally use Hyper-V because my main system is Windows and it’s what I use professionally most of the time so I’m comfortable with the ecosystem. You can use any virtualization platform you like, it really doesn’t matter. The focus here is one step after that point, getting the guest OS set up and ready for us to play with. So set up the VM or bare-metal system as you see fit. Quick note though, it does have to meet the Debian minimum system requirements – 512MB RAM, 5GB HDD for a super micro-build such as housing a Certificate Authority and nothing else. For a more broadly usable system, I’d go with 2-4GB RAM and at least 50GB HDD. If you’re planning on a full GUI install (MATE or something like that), then treat it like you would a real desktop system and go for at least 4GB RAM and as big a HDD as you think you need. If you’re working with a virtual machine in Hyper-V, you can always set a large HDD maximum size and use a ‘dynamically expanding disk’ so that only what you actually use is physically allocated.

Hyper-V options

In case you’re also using Hyper-V, here’s a few options you should set to make things work properly.

Hyper-V Networking

With other virtualization platforms you’ll have to decide on your networking as per that particular platform. For Hyper-V, you can go ahead and just start with the ‘Default Switch’ (see my article: Hyper-V Default Switch - easy LAN/internet access for guest VMs) for your initial setup. That way you’ll automatically have DHCP addressing, internet and LAN access and bidirectional communication between the host and guest system. You can switch to a dedicated NAT network (see my article: Easy internet access for Hyper-V guests using NAT later if you need to or can take the network away entirely (or switch to a ‘private network’) later if you need an air-gapped system for things like a Certificate Authority.

Get installation media

Before you can install Debian, you need to download it, right? Go over to the Debian distribution page and choose an image to download. Since our VM will have internet access via the host system, you can get the small installation image and choose your platform accordingly. In most cases, I’d assume you’re picking the amd64 installation image. This will download an ISO that you can directly load in your VM and you’re off to the races.

Hyper-V

Assuming you’re using Hyper-V, here are some notes you should be aware of:

Install Debian

The Debian installation is pretty straight-forward and wizard driven, so you shouldn’t have any problems. I’m only going to point out places where things differ from the defaults and with an eye to creating a base system. I generally use the text-based installer but you can use the ‘Graphical install’ if you’d prefer.

Network

You should just let DHCP do the work here (that’s why I recommend the Default Switch on Hyper-V) so that things are easy. You can change the networking after installation as needed for your environment.

Naming

Although you can change your hostname and domain very easily after install, you should probably just set it properly in the first place, so take a second and put a little thought into this part.

Passwords

Here’s one area where you might be surprised by what I’m about to recommend. I set “1234” as my passwords for the root user and the additional user the wizard creates. Why? Because it’s easy! In the post-install set up we’ll change these to proper passwords and use ssh-keys, etc. but, for now, make your life easy and just use a very simple password.

Partition disks

For the majority of setups you can keep things simple and just use the ‘Guided - use entire disk and set up LVM’ option for setting up your disks, especially if you’re just starting out in your Linux adventures. One note though, regardless of your experience level, I suggest you use the LVM as it gives you many more options later. Seriously, do this even if you have no idea what LVM is.

Software selection

This part is obviously up to you, but since we’re setting up a MINIMAL system, I usually only choose the following:

Post-installation

Congrats! You’re all set up! Now, let’s get this thing a little customized and secured. Assuming you followed my advice, you can login as ‘root’ with password ‘1234’. Again, I do this because the Hyper-V console connection does NOT have clipboard functionality with the Debian command-line so pasting a complex password is impossible. Also, you only have 60 seconds to type a complex password at the prompt, so that’s pretty tough too. When we get SSH set up, you can use nice long passwords and keys to keep things safe, but for now, simple is almost necessary.

Helper-archive (optional download)

I’ve put together the configuration files I use for all my base system installations and made a script to copy everything to the right locations. It updates your default bash profile and new user profile template files with a simple colourized prompt, colourizes directory listings, adds some useful command aliases, sets up nano with things like line numbers and keyboard shortcuts and makes NTP timesync pretty simple. In addition, it has an sshd configuration file included so you can save typing that out yourself. I’m going to go over all this stuff anyways, but if you don’t want to fuss with all the typing, then you can download everything in one of two ways:

Option 1: Clone the git archive

You can clone the git archive I use to store and update my configurations. This ensures you have the most recent updates, but involves you installing git on your system (which is pretty useful, actually). If space is really at a premium, however, this may not be your best choice. Here’s how you do it… Log in/switch to your root user and then:

apt update
apt install git
cd /usr/local/src
git clone https://git.asifbacchus.app/asif/DebianConfigs.git

This will create a directory called ‘DebianConfigs’ in your /usr/local/src/ directory and within that is a directory called ‘configs’ that contains copies of all the files you’ll need to duplicate my base-system setup. There’s also a bash script called ‘customize.sh’ that you can run to backup your configuration files and copy mine over them automatically. (To all my American friends… ‘customize’ is how we spell ‘customise’ here in Canada). Then you can follow along with the rest of this post to customize those files or just consult the readme.md files in the git archive. Run the script as follows (as root!):

/bin/bash /usr/local/src/DebianConfigs/customize.sh

Option 2: Download ‘release’ zip/tar

Every time I make changes to my default base-system configurations, I put them together in a zip/tar ‘release’ archive that you can download and extract. This is a better option for systems where you don’t want to install git. However, the configurations may be slightly older than those in the raw git archive. Grab the latest release in your preferred format here. Extract and use the script as explained in the section above.

Networking

Your first task is to get the network set up as you will need it. In my article, Hyper-V Default Switch – easy LAN/internet access for guest VMs, I go though the times when the Default Switch is not appropriate. Those points may also apply to other virtualization platforms. Otherwise, if the network is set up the way you like you can just leave everything as-is. Most commonly, however, you need a static setup. In that case, quickly hop over to my article on Setting up a Static IP on a Debian machine and, if you’re using Hyper-V, check out my article Easy internet access for Hyper-V guests using NAT so you still have internet access if needed. After all that, come back here.

Sudo

It’s bad practice to use your root account unless absolutely necessary and even then, never by remote. In fact, your root account should ONLY be accessible via the physical/virtual console. So, let’s get sudo set up now and give our user account (created during setup) permission to use it. First, let’s install sudo:

apt install sudo

Great, halfway there. Sudo grants permission for it’s use to any users in the sudo group. So all we have to do is add our user to that group.

usermod -aG sudo username

That’s it. Our standard user is now part of the sudo group and can run commands as root using his/her own password. If you want to learn more about sudo, how it works and how to configure it, check our my article Installing sudo on a Debian system and understanding sudoers

SSH

Now is a really good time to get SSH set up on your new VM so that you can access it easily and efficiently. This is especially true if you’re running it on a Hyper-V host since not having a clipboard is a huge PITA. Take a quick look at my article Setting up SSH with ED25519 user and host keys for easy, secure access and then come back when you’re done. Note: If you downloaded my DebianConfigs helper-archive, you already have a copy of the sshd_config file used in that article so you don’t have to type it manually :-)

Passwords

Ok, you should be able to login to your system via SSH now without passwords and without security prompts. Nice work! Most of our interactions with our system will be via SSH so we can go ahead and make our passwords super-long and very strong. This goes for not only the root password, but also any and all accounts that have sudo access because, for all intents and purposes, they are root accounts too! Now, you are correct in thinking that we will still have to input those passwords when we use sudo for root access. However, because we have bidirectional clipboard access via SSH (which we didn’t have with the Hyper-V console) we can store those long passwords securely in a password manager and copy/paste them when needed. Make sense? Even if you choose not to go this route, we still MUST change our passwords from ‘1234’.

Log in as your user-account (SSH or console) and type passwd. You’ll be prompted for your current password, a new password and then asked to confirm your new password. Let’s change our root password by first changing to the root account and then typing passwd:

sudo -s
passwd

You’ll be prompted for the new password and asked to confirm it (current password is unnecessary). That’s it, passwords updated! Now, don’t forget them!

Prompts, Colourization & Aliases (OPTIONAL SECTION)

Helper archive -- read me

If you downloaded the helper archive and ran the customize.sh file, then all of this section is already done for you! You can still read this section if you’re curious how it all works though. Otherwise, feel free to skip ahead.

N.B. Although your customizations have been applied, the user account created by the installation wizard will NOT have been updated, as you may or may not have already noticed. This is because the account’s ~/.bashrc was already created and not copied from /etc/skel/.bashrc. Let’s fix that… by the way, the fix is the same for any user account that has not inherited the new settings from the skeleton profile. Log in as that user and then:

cd ~
cp /etc/skel/.bashrc ./

That’s it – log out and back in and you’ll see the shiny new prompt.

If you need to do this for your root account for some reason, you must copy the .bashrc file from the helper archive’s config/root/.bashrc and not use the skeleton profile since it’s a different setup for your root account versus user accounts.

This section is not really critical, but it does make working on your system a lot easier, faster and a little safer especially when performing actions as root. We’ll be creating a more informative and colourful prompt, then adding some colour to our directory displays so you can tell different files and directories apart at a glance and finally, adding some command aliases to cut down on how much we type.

Custom prompt

The default prompt is not bad, but I like a little more detail in my prompt and some colour. Most important, I like to be reminded if I’m working as a normal user or as a root user. So, I set my prompt to display the time, my username and machine hostname, and the current working directory. In addition, I like my username to be in red if running as root or green if I’m running as a regular user.

There are several ways to set a custom prompt, but I like to use /etc/bash.bashrc for the reasons I outlined in my article Custom prompt and command aliases: Why I choose bash.bashrc. So open /etc/bash.bashrc in your text-editor of choice (nano is always a good choice) and add the following to the end of the file:

force_color_prompt=yes
# Test for root and change prompt username to RED, otherwise username is GREEN
if [ $(id -u) -eq 0 ]; then
	PS1='[$(date +%H:%M)] \[\033[00;31m\]\u\[\033[00m\]@\[\033[00;33m\]\h\[\033[00m\]:\w\$ '
else
	PS1='[$(date +%H:%M)] \[\033[00;32m\]\u\[\033[00m\]@\[\033[00;33m\]\h\[\033[00m\]:\w\$ '
fi

Complicated, right? Not really, but I’m not going to explain it much either. The reason is that it’s easier to see it for yourself (if you’re interested) by constructing a prompt on your own using a configuration generator. That way you can understand each of the ANSI colour escape codes and the prompt escape codes. Go take the Easy Bash Prompt Generator for a test drive and you’ll see what I mean. Hey, you might even make something you like more than mine and you can substitute that PS1= code into your /etc/bash.bashrc file! If you create a really cool prompt, let me know in the comments and I’ll link it up on the site :-)

If you are playing with different prompts, you don’t have to login and logout to see your changes. Simply type the following after saving your changes in /etc/bash.bashrc:

source /etc/bash.bashrc

That will refresh your prompt instantly and you can bask in your glorious new prompt or fix any mistakes you’ve made!

Colourize directory listings

This one is super useful and let’s you see at-a-glance which names are directories, which files are executable, etc. on every directory listing. Again, I like making this change in /etc/bash.bashrc. Open it up and append this to the end:

# Colourize directory listing
export LS_OPTIONS='--color=auto'
eval "`dircolors`"

Quick note: Those are backticks around ‘dircolors’. The backtick is the key next to your “1” key on your keyboard that also has the tilde (~) symbol. It’s like the weird cousin of the single-quote but has a special meaning in Linux. Make sure you use double-quote backtick dircolors backtick double-quote or it won’t work.

Again, you can immediately enact this change using the source trick we learned in the previous section or just log out and back in then generate a directory listing using ‘ls’.

Command aliases

Command aliases are incredible. They let you define what you type to execute whatever commands you want (within reason). I like using them to define stuff like exactly how my directory listings appear, for example, so I can just type ‘l’ instead of ‘ls -lAsh –group-directories-first’. You can set up any aliases you like using my examples as a reference. Again, I put them in /etc/bash.bashrc but you can also quite reasonably put them in ~/.bashrc so they only affect your user account. Open which ever file you prefer and append your aliases to the end of the file. I use these, as an example:

# Command aliases
alias ll='ls $LS_OPTIONS -l'
alias l='ls $LS_OPTIONS -lAsh --group-directories-first'
alias ld='ls $LS_OPTIONS -ldsh'
alias rm='rm -i'
alias mv='mv -i'
alias cp='cp -i'

You can see the basic structure is the alias (i.e. what you type) on the left and then what it means on the right. In my example, I add the -i (‘interactive’) flag to all my copy, move and and delete commands so I have to confirm each file. This stops me accidentally overwriting or carelessly deleting files without a second-thought. Go ahead an add as many or as few aliases as you like.

Once again, you can immediately enact these changes by re-sourcing your /etc/bash.bashrc or your ~/.bashrc, depending on which one you changed, or just logging out and back in again.

NTP time synchronization

Especially if you’re running a server, time synchronization is pretty important. Fortunately, it’s also really easy to get running. All recent versions of Debian use systemd-timesyncd instead of the full-fledged ntpd package and this is just fine. Configuration is handled via a configuration file and the timedatectl command. Here’s a quick overview of key files and commands:

Command/FilePurpose
timedatectlShow status of timesyncd, set time, timezone and enable/disable NTP sync
systemctl … systemd-timesyncdControl the timesyncd service and display status
/etc/systemd/timesyncd.confSet configuration options, most commonly the list of NTP servers to use

All we should need to do is update the configuration file to use the NTP servers we want and then restart the service. If you downloaded the helper-archive and ran the customization.sh script, then the template file has been copied for you. If not, the default file is easy enough to modify. Either way, open /etc/systemd/timesyncd.conf and edit the NTP= to list the timeservers you wish to use, separated by spaces. If you need help finding a timeserver to use, check out the NTP.org list page and browse to the geographically closest area then use those timeservers. They are free, accurate, used by millions and very safe. I’m in Canada, so I generally use the National Research Council’s timeservers (in the US you might use NIST servers, for example). When you’re done editing your file, the last few lines should look something like this:

NTP=time.nrc.ca time.chu.nrc.ca
FallbackNTP=0.ca.pool.ntp.org 1.ca.pool.ntp.org 2.ca.pool.ntp.org 3.pool.ntp.org

In this case, I’ve used the NRC timeservers as my primary and the NTP.org servers for Canada as my fallback servers. The fallback servers are completely optional. You’ll notice in the default file they are commented out, you can leave it this way if you like. An equally valid setup would be something like this:

NTP=0.ca.pool.ntp.org 1.ca.pool.ntp.org 2.ca.pool.ntp.org 3.pool.ntp.org
#FallbackNTP=0.debian.pool.ntp.org 1.debian.pool.ntp.org 2.debian.pool.ntp.org 3.debian.pool.ntp.org

This is pretty much the default file with the NTP servers updated.

Once that’s done, save the file and restart your timesyncd service.

systemctl restart systemd-timesyncd.service
systemctl status systemd-timesyncd.service

You should see that the service is ‘running’ and is reporting that it is syncing to one of the servers that you have specified. We need to check one more thing just to be completely sure things are working. Go ahead and type timedatectl. This should show the correct time (haha) and should also state NTP synchronized: yes. If it does not, then type timedatectl set-ntp TRUE. Then, restart the service as we did above and check it’s status one more time by running timedatectl. Everything should be working now.

Configure nano (OPTIONAL)


The last thing I like doing on my base-systems is to set up nano with some useful defaults. As you may have noticed, I like using nano for all my editing. I find vi too cumbersome and think that nano does a great job of balancing features and ease of use. Ultimately it’s up to you. I like setting nano to open multiple files at once, display line numbers, auto-match brackets and quotes, auto-indent and I map a few custom keystrokes.

If you downloaded the helper-archive and ran the customize.sh script, then all these changes have been done for you. If you just want the updated nano configuration, grab it here. There’s too many changes to go into individually but, you can diff the default vs my changes and see what options I’ve enabled. I will, however, quickly summarize the keyboard shortcuts that I added:

ShortcutFunction
ctrl-ssave current file
alt-ccopy highlighted text
alt-xcut highlighted text
alt-vpaste clipboard contents

Final thoughts

Well, that’s finally it – exactly how I set up my Linux base-systems. Virtually every other tutorial you’ll find on this site that uses a Debian server starts with this exact setup. I know this has been a loooong article and thank you for sticking it out to this point. I hope this has given you a clear set of instructions on how to set up a solid Debian-base system. Using this setup, you can add components and programs to quickly create a webserver, WordPress system, git server, certificate authority, and so many other things – enjoying experimenting!


Thanks for reading my techie-thoughts on this issue. Have any comments or suggestions? Want to add your tips? Things you want me to cover in a future article? Comment below!