diff --git a/avahi/README.md b/avahi/README.md
new file mode 100644
index 0000000..984c113
--- /dev/null
+++ b/avahi/README.md
@@ -0,0 +1,32 @@
+# Avahi
+
+
+# Import notes
+
+To allow avahi to work, you will want to use it on your lan, with the macvtap driver. This is because avahi need to broadcast to your lan network.
+
+
+You may need to enable macvlan:
+```
+networks:
+ lan:
+ name: lan
+ driver: macvlan
+ driver_opts:
+ parent: enp1s0
+ ipam:
+ config:
+ # This should be your lan network
+ - subnet: 192.168.42.0/24
+ #- subnet: 192.168.42.144/28
+ # 192.168.42.145 -> 192.168.42.158
+ # 192.168.42.159
+
+services:
+ avahi:
+ networks:
+ lan:
+ # This IP is outside my DNS range of my lan
+ ipv4_address: 192.168.42.100
+
+```
diff --git a/avahi/conf/hosts b/avahi/conf/hosts
new file mode 100644
index 0000000..04b562d
--- /dev/null
+++ b/avahi/conf/hosts
@@ -0,0 +1,2 @@
+# Example:
+# 192.168.42.18 files.local
diff --git a/avahi/conf/services/sftp-ssh.service_DIS b/avahi/conf/services/sftp-ssh.service_DIS
new file mode 100644
index 0000000..dfae4f1
--- /dev/null
+++ b/avahi/conf/services/sftp-ssh.service_DIS
@@ -0,0 +1,34 @@
+
+
+
+
+
+
+
+
+
+ %h
+
+
+ _sftp-ssh._tcp
+ 22
+
+
+
diff --git a/avahi/conf/services/smb.service b/avahi/conf/services/smb.service
new file mode 100644
index 0000000..47ff4d2
--- /dev/null
+++ b/avahi/conf/services/smb.service
@@ -0,0 +1,18 @@
+
+
+
+ files.domain
+
+ _smb._tcp
+ 139
+ files.local
+ model=Samba server
+
+
+ _device-info._tcp
+ 0
+ model=Docker
+ files.local
+
+
+
diff --git a/avahi/conf/services/ssh.service b/avahi/conf/services/ssh.service
new file mode 100644
index 0000000..27dcb65
--- /dev/null
+++ b/avahi/conf/services/ssh.service
@@ -0,0 +1,12 @@
+
+
+
+
+
+ domain.org
+
+ _ssh._tcp
+ 22
+ domain.org
+
+
diff --git a/avahi/docker-compose.yml b/avahi/docker-compose.yml
new file mode 100644
index 0000000..a169da5
--- /dev/null
+++ b/avahi/docker-compose.yml
@@ -0,0 +1,19 @@
+version: "3.7"
+
+networks:
+ lan:
+services:
+ avahi:
+ image: flungo/avahi
+ volumes:
+ - $app_dir_conf/hosts:/etc/avahi/hosts
+ - $app_dir_conf/services:/etc/avahi/services
+ # See: https://linux.die.net/man/5/avahi-daemon.conf
+ # See: https://hub.docker.com/r/flungo/avahi
+ environment:
+ SERVER_HOST_NAME: mdns
+ #SERVER_HOST_NAME: $app_fqdn
+ #SERVER_DOMAIN_NAME: faketest
+ networks:
+ lan:
+