diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..e69de29
diff --git a/README.md b/README.md
index e1194f6..20b5729 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,3 @@
-# homeAutomation
\ No newline at end of file
+# Home Automation project
+
+This repo describes my setup for Home Assistant.
diff --git a/Server.md b/Server.md
new file mode 100644
index 0000000..beb54bb
--- /dev/null
+++ b/Server.md
@@ -0,0 +1,36 @@
+# Server setup
+
+## Installation docker
+
+- See [Official Website](https://docs.docker.com/engine/install/ubuntu/)
+
+## Setup VPN client
+
+Follow [this tutorial](https://docs.pivpn.io/wireguard/)
+
+NOTE: on ubuntu, you need to add a symbolic link in order to enable the VPN ([source](https://superuser.com/a/1544697))
+
+```bash
+ln -s /usr/bin/resolvectl /usr/local/bin/resolvconf
+```
+
+## Setup Home Assistant
+
+```bash
+sudo docker run -d \
+  --name homeassistant \
+  --privileged \
+  --restart=unless-stopped \
+  -e TZ=Europe/Brussels \
+  -v /home/willem/homeassistant:/config \
+  --network=host \
+  ghcr.io/home-assistant/home-assistant:stable
+```
+
+Now, home assistant can be accessed at http://<host>:8123
+
+## To Do
+
+- Now, you can only connect to the home assistant server when you are connected to the VPN - is this OK or should this be changed?
+- Start the VPN client automatically after reboot
+
diff --git a/VPN.md b/VPN.md
new file mode 100644
index 0000000..9c1752a
--- /dev/null
+++ b/VPN.md
@@ -0,0 +1,18 @@
+# VPN setup
+
+## OS
+
+I used a raspberry pi with Raspberry PI OS lite on it.
+
+>Best to use Raspberry Pi Imager to flash image onto SD card. This flasher allows you to enable SSH and configure WLAN during flashing
+
+After that, I followed [this tutorial](https://pimylifeup.com/raspberry-pi-wireguard/)
+
+Notes on the tutorial:
+
+- Working with a no-ip hostname did not work. Probably because I did not wait long enough after configuring the hostname? For now, I have configured an IP address, but this is not ideal, as the IP address can change.
+- After configuring the pivpn, best to run `pivpn -d` to fix an iptables issue (see [faq](https://docs.pivpn.io/faq/))
+
+## To Do
+
+- Raspberry pi should have a private key SSH login
\ No newline at end of file