ubuntu-2204: a free Ubuntu Server course written as a repository of notes

This is a course repository, not a toolkit

The ubuntu-2204 repository is the written companion to a free course on Ubuntu Server 22.04.x LTS, published by the Bora para Prática project and taught by Robson Vaamonde. The repository description says it plainly: a free GNU/Linux Ubuntu Server 22.04.x LTS Essentials course.

That framing changes what the repository is for. There is no package to install, no library to import and no command with flags to memorise. The primary language is recorded as Shell, but that reflects the commands demonstrated in the notes, not a shipped tool.

The stated objective of the course is to demonstrate the installation and configuration of Canonical's new server release, with the installation and configuration of the main network services carried out manually, following good implementation practices for Localhost, Intranet, Extranet or Internet Cloud services. The course is positioned as the base for a follow-up on DevOps concepts, with CI/CD, with the intent of moving the whole structure from on-premises servers to the cloud or into containers with Docker, and with a later stage automating virtual machine creation with Vagrant and Ansible.

So the repository is best read as a curriculum with a stated trajectory. The first release is titled Agenda MongoDB and dates from 2024-04-29.

The primary language of the course content is Portuguese, and that is the single most important practical fact about the repository for an English speaking reader. The video course is in Portuguese, the notes are in Portuguese, and the linked documentation files carry Portuguese names.

The numbered stage directories are the actual course outline

The top level listing of the repository is a numbered sequence, and that sequence is the course structure.

The first stage is 01-install/, which is the installation of Ubuntu Server 22.04.x LTS on Oracle VirtualBox. The second is 02-settings/, the base configuration of the installed server, including the update to the Pro release described in the README. Then 03-services/ for the network services, 04-news/ for news and updates on the distribution, 05-integrations/ for integrations with other tools, 06-security/ for the hardening stage, and 07-challenges/ for what the author calls the challenges of the environment.

Alongside the stages there are files with names rather than numbers: BUGS, CHANGELOG, FAQ, HELP, NEWS, PORTS, RELEASE and ROADMAP. The presence of a FAQ, a BUGS file and a CHANGELOG in a teaching repository is a sign of how it is meant to be used, as a maintained body of course notes rather than a one-off upload.

The remaining directories are supporting extras. conf/ holds configuration, script/ holds scripts, selos/ holds what appear to be course seals or badges, and war/ is a separate directory whose purpose is not described in the documentation available.

Two of the numbered stages are worth calling out separately because they are where the stated long term value lies. 05-integrations/ is where the DevOps direction becomes concrete, and 07-challenges/ is a distinctly named stage rather than a numbered topic, which suggests it collects the problems the author hit while building the whole environment.

How the notes and the videos link together

Each stage in the README follows the same pattern. There is a heading for the lesson, a paragraph describing what the video covers, a thumbnail, a link to the video and a link to the written documentation file.

The installation lesson is the clearest example. The video shows how to download the Ubuntu Server ISO from the official site, how to create and customise the virtual machine in VirtualBox, and how to perform the standard Ubuntu Server installation, with the configuration stage beginning in the next video. The corresponding notes live in the repository at a path that names the file:

Link da documentação: https://github.com/vaamonde/ubuntu-2204/blob/main/01-install/01-InstalacaoDoUbuntuServer-22.04-LTS.md

The video itself is referenced the same way, by its identifier:

Link da vídeo aula: https://www.youtube.com/watch?v=qnMol8-wvq8

and the introduction lesson for the course is at:

Link da vídeo aula: https://www.youtube.com/watch?v=kkhTHvZKQlM

The complete playlist is linked from the repository homepage, and the README also links it under its own heading of playlist links.

This two-track structure is the point of the repository. The video shows the screen and the typing, the markdown file holds the written steps you can read at your own speed or search. For a learner who wants to follow along in a terminal, the markdown is the usable artefact, and the video is there to resolve the parts where a text description of a GUI click is ambiguous.

The upstream documentation the project points at

The README collects official links rather than restating the documentation, and the list is worth reading because it shows what the course is built on top of.

For the distribution itself there is Canonical at canonical.com, Ubuntu at ubuntu.com, Linux Mint, Oracle VirtualBox, Vagrant from HashiCorp at vagrantup.com, and Ansible from Red Hat at ansible.com. For documentation there is the Ubuntu Server Guide at ubuntu.com/server/docs, a full PDF version of that guide hosted on assets.ubuntu.com, the Vagrant documentation on devdocs.io, and the Ansible documentation.

The README also defines the vocabulary the course uses, in its own words. Ubuntu is described as an open source operating system built from the Linux kernel and based on Debian, developed by Canonical Ltd. Cloud is defined as on-demand availability of computer system resources, especially data storage and computing capacity, without active direct management by the user. Vagrant is described as open source software for creating and maintaining portable virtual development environments using VirtualBox, KVM, Hyper-V, Docker, VMware, AWS and similar, with the goal of simplifying software configuration management. Docker is described as a set of platform as a service products that use operating system level virtualisation to deliver software in packages called containers, which are isolated from each other and bundle their own software, libraries and configuration files. Ansible is described as an open source IT tool for managing, automating and configuring servers and deploying applications from a central location, including its own declarative language for describing system configuration.

Those definitions are a good sign of the course's intent. It is not asking you to copy commands you do not understand. Each tool the course introduces is defined in terms of what problem it solves, which is the level of detail a beginner needs and an expert can skip.

The licensing and the project structure around the course

The repository is MIT licensed, and it carries a LICENSE file alongside a separate file with a Portuguese name for the licence, LICENÇA. There is also a .vscode directory, which suggests some of the notes are edited as a workspace rather than as loose files.

The maintainer is prominent in the README, which lists a set of linked properties rather than a bare name. Procedimentos em TI at procedimentosemti.com.br is the personal blog, Bora para Prática at boraparapratica.com.br is the project site, vaamonde.com.br is the author's own site, and there are Facebook, Instagram and YouTube presences for both the project and the personal channel, plus a LinkedIn profile and a GitHub profile.

The README also carries explicit donation requests, including a PIX key, a PagSeguro link and a PayPal link, with the stated purpose of keeping the project producing free videos and course content for the YouTube channel. That is a normal arrangement for a free course, and it tells you the videos are not going away because someone is funding them.

The project structure reinforces the stage model. The numbered directories hold the notes for each phase, conf/ and script/ hold the configuration and scripts used in the demonstrations, and the changelog style files track what changed. The CHANGELOG, NEWS, RELEASE and ROADMAP combination is what you would expect from a project that expects to keep updating alongside the distribution it teaches, since Ubuntu Server 22.04.x receives point releases over its supported lifetime and a course pinned to a specific point release would drift.

For a learner, the practical navigation is straightforward: start at 01-install and work forward, and treat the official Ubuntu Server Guide linked in the README as the reference to check any command against.

Editorial conclusion

Adopt ubuntu-2204 if you learn best from a staged, video-backed walkthrough of Ubuntu Server administration and you read Portuguese, since the notes and the videos share one structure. Do not adopt it as a source of configuration files to copy into production, because the repository is course notes and the services are configured manually by hand in the demonstrations. Before you follow any procedure in it, check the version it targets, which is Ubuntu Server 22.04.x LTS, and compare the commands against the current Ubuntu Server documentation linked from the README, since the last push to the repository was on 2026-08-31 and the notes are written in Portuguese.

Frequently asked questions

Official sources

1. License: MIT
2. Project website
3. README
4. Releases
5. vaamonde/ubuntu-2204 on GitHub