Update 'docs/how-to-guides/email filters.md'

docs/how-to-guides/How-to-add-devices-to-a-network.md

@@ -0,0 +1,44 @@
+# How to add a user’s device to a network  
+In order to add a device to the network you would need to use the device’s MAC address
+The process for find the MAC addresss differs between the various operating systems.
+
+
+## How to find the Mac address for the various Operating systems
+### Finding your Mac address - IOS 
+1. Open the Settings app
+2. Select General
+3. Select About
+4. Scroll down and note Wi-Fi Address
+5. The Wi-Fi address is your Mac address 
+
+### Finding your Mac address - Android
+1. Open the Settings App
+2. Select Wi-Fi
+3. Select the Menu icon and choose Advanced
+4. Note the MAC address
+
+### Finding your Mac address - Mac
+1. Open System Preferences from the Apple menu
+2. Select Network
+3. Select Airport from the sidebar, then Advanced
+4. Select the Airport tab, note the Airport ID
+5. The Airport ID is your Mac address 
+
+### Finding your Mac address - Windows
+1. Hold down the Windows key and 'R' simultaneously
+2. Enter cmd.exe
+3. Enter ipconfig/all
+4. Scroll up to find the Wireless LAN adapter section
+5. Note the Physical Address
+6. The Physical Address is your Mac address
+
+### How to connect using the Mac address 
+1. Obtain the MAC Address: Locate the MAC address of the device you want to add to the network. You can usually find it in the device's network settings or on a label/sticker on the device itself.
+2. Access the Router's Web Interface: Open a web browser on a device that is already connected to the Synology router's network. Enter the router's IP address (e.g., 192.168.1.1) in the address bar and press Enter to access the router's web Interface
+3. Login to the Router: Enter your administrator username and password to log in to the router's web interface. If you haven't changed the default credentials, check the router or its user manual for the default login information.
+4. Navigate to MAC Filter Settings: Once logged in, locate the "MAC Filter" or "Wireless MAC Filter" option. It is typically found under the "Wireless" or "Network" settings section, but the exact location may vary depending on your router model and firmware version.
+5. Add Device to MAC Filter: In the MAC filter settings, look for an option to add a new MAC address or device. Enter the MAC address of the device you want to add to the network. Specify the appropriate filtering mode (e.g., allow or deny) for the device's MAC address.
+6. Save the Settings: Once you have added the device's MAC address to the MAC filter list and specified the filtering mode, click on the "Save" or "Apply" button to save the MAC filter settings.
+7. Connect the Device: Connect the device you want to add to the network to the Synology router. Use an Ethernet cable or connect to the router's wireless network, depending on the device's capabilities.
+8. Verify Network Connectivity: Once connected, check if the device has successfully obtained an IP address from the router and can access the internet or other devices on the network. Ensure that the device is functioning properly on the network.
+9. Test the Connection: Test the network connection on the added device to ensure it can access the internet and other network resources as intended. Verify that the device can communicate with other devices on the network.

docs/how-to-guides/Mac Filter.md

@@ -0,0 +1,20 @@
+### Create MAC filter rules
+1. Go to Wi-Fi Connect > Wi-Fi Settings > MAC Filter.
+2. Click the Create button.
+3. Enter the MAC filter name and select an access policy:
+    * 		Deny: Restricts the specified MAC address from accessing the wireless network.
+    * 		Allow: Restricts all access to the wireless network except for the specified MAC address.
+4. To add devices to your MAC filter, select a connected device or manually specify a device name and MAC address.
+5. Determine whether to Automatically apply this filter to all Wi-Fi names.
+6. Confirm your settings and click Apply.
+
+### Edit the system block list
+1. Go to Wi-Fi Connect > Wi-Fi Settings > MAC Filter.
+2. Click on System Block List.
+3. Edit the device list:
+    * 		Add a device to the list: Select a connected device or manually specify a device name and MAC address.
+    * 		Remove a device from the list: Click the x under the Delete column.
+4. Click OK to save the settings.
+
+
+

docs/how-to-guides/email filters.md

@@ -0,0 +1,36 @@
+# Create rules to filter your emails
+On your computer, you can manage your incoming mail using Gmail’s filters to send email to a label, or archive, delete, star, or automatically forward your mail.
+
+## Create a filter
+ 1. Open Gmail.
+2. In the search box at the top, click Show search options 
+3. Enter your search criteria. If you want to check that your search worked correctly, see what emails show up by clicking Search. 
+4. At the bottom of the search window, click Create filter.
+5. Choose what you’d like the filter to do.
+6. Click Create filter.
+Note: When you create a filter to forward messages, only new messages will be affected.  Additionally, when someone replies to a message you've filtered, the reply will only be filtered if it meets the same search criteria. 
+
+## Use a particular message to create a filter
+1. Open Gmail.
+2. Check the checkbox next to the email you want. 
+3. Click More 
+4. Click Filter messages like these.
+5. Enter your filter criteria. 
+6. Click Create filter.
+
+## Edit or delete filters
+1. Open Gmail.
+2. At the top right, click Settings 
+3.  See all settings.
+4. Click Filters and Blocked Addresses.
+5. Find the filter you'd like to change.
+6. Click Edit or Delete to remove the filter. If you’re editing the filter, click Continue when you’re done editing.
+7. Click Update filter or OK 
+
+## Export or import filters
+If you have a backup of your filters, you can import the filters in Gmail. You can also export your filters.
+1. Open Gmail.
+2. At the top right, click Settings 
+3. See all settings.
+4. Click Filters and Blocked Addresses.
+5. Check the box next to the filter.

docs/services/docker/droneci.md

@@ -0,0 +1,4 @@
+# DroneCI 
+DroneCI is an automation tool that simplifies the testing and deployment of software changes, improving collaboration and code quality. It automates build and test processes, integrates with version control systems, and provides visibility for team members. By reducing manual tasks and enhancing collaboration, DroneCI accelerates the software development cycle and ensures reliable code deployments.  
+ 
+ DroneCI and Gitea work together to automate the creation of KH3's IT documentation website. DroneCI connects to the Gitea IT repository and automatically builds the mkDocs website whenever there are changes to the code or documentation. This ensures that the website is always up-to-date without requiring manual intervention. It simplifies the process, saves time, and helps keep KH3's IT documentation easily accessible for the team.

docs/services/docker/gitea.md

@@ -0,0 +1,5 @@
+# Gitea  
+Gitea is a self-hosted, lightweight Git service that provides a user-friendly interface for managing source code repositories. It allows teams to collaborate on software development projects by providing features like version control, issue tracking, and code reviews. Gitea simplifies the process of setting up a Git server, making it accessible to individuals and small teams who want to keep their codebase secure and under their control.
+
+ 
+ Gitea is a platform used to store and manage all of KH3's IT documentation and configuration files. It provides a secure and collaborative space where the team can work together to update and organize these important resources. Gitea allows multiple team members to make edits, track changes, and communicate efficiently. It integrates with other tools and services, making it easier to connect the documentation with other IT processes. Overall, Gitea simplifies the management of KH3's IT documentation and promotes effective collaboration within the team.

docs/services/docker/graylog.md

@@ -0,0 +1,6 @@
+#  Graylog
+Graylog is a special tool that helps people who manage computer systems to keep an eye on how everything is working and fix any problems that come up. It does this by collecting and studying log information from different programs and machines. By putting all the log data in one place, Graylog makes it easy to search for specific information and figure out what might be causing issues. Graylog works with different types of logs and makes it simple to understand what's happening in the computer system. It's like having a detective that helps keep everything running smoothly.  
+
+
+In KH3's infrastructure, there are many different services running, such as websites, databases, and applications. These services generate log data, which contains valuable information about how they are functioning. Graylog acts as a central hub where all these logs are collected and stored.
+ 

docs/services/docker/pihole.md

@@ -0,0 +1,5 @@
+#  Pi-hole
+
+Pi-hole is a special tool that blocks ads on your devices when you're using the internet. It runs on a small computer and stops ads from showing up on your screen. This makes your internet faster and keeps your privacy safe by preventing advertisers from tracking you. Setting up Pi-hole is easy, and it gives you control over what you see online. It's like having your own personal ad blocker that makes your browsing experience better.  
+ 
+ Pi-hole is an important tool used in KH3 to manage internet traffic. It acts as the main control point for all devices on your network, blocking unwanted ads and restricting access to malicious websites. Pi-hole also simplifies access to local services by assigning easy-to-remember names instead of complicated IP addresses. It ensures a safer and more efficient internet experience for KH3, enhancing security and productivity.

docs/services/docker/traefik.md

@@ -0,0 +1,7 @@
+# Traefik 
+Traefik is a smart tool that helps make sure your apps work well. It sits between your devices and the servers hosting your apps, like a traffic controller. It takes the requests from your devices and sends them to the right server, making sure everything runs smoothly.  
+Traefik also balances the work across many servers, so not one server gets too busy. This helps your apps run faster and stay reliable, even when lots of people are using them.
+
+
+
+It is configured with  cloudfare to request and let's you encrypt wildcard certificate [*.office.kh3group.com](*.office.kh3group.com) used by most of the locally hosted services In KH3’s IT infrastructure. Furthermore it is set up automatically to renew the wildcard certificate on 3-month schedule, this ensures it is always up to date. Also it acts as a reverse proxy, working with pinhole that acts as a local DNS to ensure that locally hosted services are reachable by their host name e.g: you can access KH3’s IT documentation on any device on the KH3 local network by visiting [docs.office.kh3group.com](docs.office.kh3group.com)