How to document a project with MkDocs πŸ“Ή


Welcome my third video tutorial, this time, on how to get started with MkDocs.

In this video I try to give you a basic overview of MkDocs and a configuration consisting of the material theme and search plugin.


The MkDocs configuration used in the video.

site_name: My Cool Project Documentation
  name: material
    - search.suggest
    - search.highlight
  - search
  - Introduction: ""
  - Tutorial:
      - Tutorial Subsection: "pages/tutorial/"
  - About: "pages/"
  - FAQ: "pages/"
  - attr_list

Docker Deployment

When you’re ready to deploy your documentation website, say in Docker with Nginx the following Dockerfile and Nginx default.conf should do.


FROM python:3.9 as builder


COPY . .

RUN pip install mkdocs mkdocs-material && mkdocs build

FROM nginx as deploy

# Copy the build to the nginx directory.
COPY --from=builder /app/site/ /usr/share/nginx/html/

# Copy the nginx configuration to the nginx config directory.
COPY default.conf /etc/nginx/conf.d/

EXPOSE 8080:8080/tcp


server {
    listen 8080;
    root /usr/share/nginx/html/;
    index index.html;

I thought that making videos will be easier that typing blog posts but to my surprise the difficulty is a bit higher. Fixing mistakes takes more time with videos and since I’m not that great of a presenter I struggle with presenting the content. Hopefully I will improve my skills with time and practice.

Thanks for reading! 🍻

πŸ’»Remote Desktop: logon attempt failed β›”

Hi πŸ‘‹

Have you ever tried to setup your Windows’s Remote Desktop functionality and failed with the following error message “logon attempt failed“, knowing that your credentials were correct and that you’re on the same Wi-Fi network with the computer you’re trying to access?

Well, I did.

Most of the solutions you’ll find on other blogs make you edit your Window’s registry, network settings and so on, which in my case was not needed, and it is somehow overkill.

Logging in with a password and my Microsoft account on the computer I wanted to setup Remote Desktop solved the issue.

What I had to do was to go in Settings > Accounts > Sign-in Options, disable Windows Hello PIN and all other sign in options, setup Password sign-in option and then relog on my PC.

That’s it.

Windows 11

If you’re on Windows 11 then you don’t have sign in with a password as an option. What worked for me is to reset my PIN using my Microsoft account during the login screen.

After resetting my PIN the Remote Desktop started working.

Running Linux GUI Applications in Windows

Hi πŸ‘‹,

This is a quick tutorial on how to run Linux graphical interface application in Windows using X Server’s forwarding feature.

The first step is to download and install the VcXsrv Windows X Server on your πŸ’» Windows machine.

Then, start VcXsrv with the following configuration:

Ensure that VcXsrv is not blocked in Windows Firewall, it should be allowed in Public and Private networks.

You may also use more restrictive firewal settings as explained in /wsl-windows-toolbar-launcher#firewall-rules.

The next step is to configure your Linux box.

I’m using Ubuntu in WSL 2.0 and pasting the following code into ~/.zshrc or ~/.bashrc does the trick for me. Feel free to upvote the author on SO.

# X11
HOST_IP=$(host `hostname` | grep -oP '(\s)\d+(\.\d+){3}' | tail -1 | awk '{ print $NF }' | tr -d '\r')
export DISPLAY=$HOST_IP:0.0
export NO_AT_BRIDGE=1

After that’s done, if VcXsrv is running, you should be able to open Linux GUI apps from your Terminal.

Thanks for reading! 🍺