**You do not need an account.** You will be connecting to my *tailnet* using an authentication key.
#### 1. Get an authentication key A Tailscale authentication key looks like this: ``` tskey-auth-k5MukmtKx621CNTRL-Te6eVCugAb9gdj27hJqYY9RNRdRcQcN1 ``` If I have not already provided you with an authentication key, **contact me.** #### 2. Open a command prompt or terminal Open the Windows search menu and type in: `cmd` [](https://wiki.joris.me/uploads/images/gallery/2024-06/RnjmwQw7NOwBXPy2-image.png) Then, click **Open**: [](https://wiki.joris.me/uploads/images/gallery/2024-06/3kZqKfIyS4LNxMBt-image.png) You should now see a window that looks like this (minus the red bar): [](https://wiki.joris.me/uploads/images/gallery/2024-06/1UXcn6bOjaPVTu3U-image.png) #### 3. Login and launch Tailscale Now that you have the command prompt open, type the following: ``` tailscale up --auth-key PUTTHEKEYHERE ```**Tip**: You can **right-click** the window to paste from your clipboard. Use this to paste the authentication key.
To illustrate, an example using the authentication key from earlier: ``` tailscale up --auth-key tskey-auth-k5MukmtKx621CNTRL-Te6eVCugAb9gdj27hJqYY9RNRdRcQcN1 ``` If all goes well, you should see basically no output: [](https://wiki.joris.me/uploads/images/gallery/2024-06/Sp6thn7bBNGCHkNa-image.png) You can check if it worked by typing `tailscale status`. If you see a list of IP addresses and device names, you are connected! ## Conclusion Good work! You are now connected to my Tailnet. This will allow you to access all services I've given you access to. You can continue to the next guide: [Add a network drive](https://wiki.joris.me/books/network-storage/page/mount-a-network-drive-windows "Add a network drive") # Connecting via WireGuard ### Introduction WireGuard is a tunneling protocol that lets you establish a secure connection, either directly to another host, or to another network or subsection thereof. This can be utilized as a VPN or as a secure entry into another network for accessing storage or other services. This article is a short walk-through of deploying a wireguard configuration you get from me to access one or more services in my homelab. ### Prerequisites - A WireGuard config file, archive with password; - The password for the archive; - A Linux machine.If you do not have such a WireGuard config archive or the password, **contact me.**
### Installing dependencies Since WireGuard comes with the kernel, we will only need to install some utilities. #### On Debian ```bash sudo apt install wireguard-tools p7zip ``` #### On Arch Linux ``` sudo pacman -S wireguard-tools 7zip ``` ### Unpacking the configThis requires a password. You either have received the password already, or will receive it from me via a channel separate to the one I used to give you the archive.
This requires 7z installed: ``` 7z x wg.7z ``` You should see a file akin to `WG-You can choose any name for the destination file; just make sure it's a legal network interface name. The below file name would result in a network interface called `wg1`.
### Connecting Assuming you named the file `wg1.conf`: ``` wg-quick up wg1 ```And you're done!
Continue reading: - [Accessing a share (rclone + SMB)](https://wiki.joris.me/books/network-storage/page/accessing-a-share-rclone-smb) - [Mount a network drive (Linux NFS)](https://wiki.joris.me/books/network-storage/page/mount-a-network-drive-linux-nfs) # Mounting storage Guides on mounting a network share on your local machine. # Mount a network drive (Windows) In this guide, we will walk through adding a **network drive** in Windows. That means going from this: [](https://wiki.joris.me/uploads/images/gallery/2024-06/kRBUN6npqjJdn39a-explorer-cipdozvxyl.png) To this: ### [](https://wiki.joris.me/uploads/images/gallery/2024-06/m7M0cfe3SeB8423N-image.png) ### Prerequisites - You have **[connected to Tailscale](https://wiki.joris.me/books/network-storage/page/connecting-via-tailscale)**. - You have received the following things from me: - The **name** of the network share created for you; - The **username and password** you need to authenticate with. - If any of these were not provided to you, please contact me. ### Before we begin..I SHALL NOT BE LIABLE FOR ANY DAMAGES OR LOSSES ARISING FROM ANY USE OF THE NETWORK SHARE, INCLUDING ANY INTERRUPTIONS TO THE NETWORK SHARE, INCLUDING, BUT NOT LIMITED TO, ANY POWER OUTAGES, SYSTEM FAILURES, NETWORK ATTACKS, SCHEDULED OR UNSCHEDULED MAINTENANCE, OR OTHER INTERRUPTIONS.
**YOU** are responsible for keeping enough backups of your data**.**
**Recommended** reading: [https://www.backblaze.com/blog/the-3-2-1-backup-strategy/](https://www.backblaze.com/blog/the-3-2-1-backup-strategy/)
With that out of the way, let's begin! ### Instructions First, open Windows Explorer, and navigate to **This PC**: [](https://wiki.joris.me/uploads/images/gallery/2024-06/g8C88HsLKom65q6Q-image.png) Then, navigate to the **Computer** tab and click the **Map network drive** button: [](https://wiki.joris.me/uploads/images/gallery/2024-06/TA0gTKuRen5sWS8O-image.png) You should be greeted by a window that looks something like this: [](https://wiki.joris.me/uploads/images/gallery/2024-06/U5VIDxu8QX1GCN0E-image.png) If you want, choose a drive letter of your choice: [](https://wiki.joris.me/uploads/images/gallery/2024-06/Mn0l8CVIvIrT4QoH-image.png) Then, for **Folder**, enter the following: ``` \\smb.ts.joris.me\yourShareNameHere\ ``` **For example**, my share is called `joris`, so for me it looks like this: ``` \\smb.ts.joris.me\joris\ ``` [](https://wiki.joris.me/uploads/images/gallery/2024-06/HuaMPDuBTasYuKpu-image.png) Then, **check the box** that says "Connect using different credentials". [](https://wiki.joris.me/uploads/images/gallery/2024-06/sMEDJbUnzs9V8ut0-image.png) Next, click **Finish**. [](https://wiki.joris.me/uploads/images/gallery/2024-06/GWiM06tJOScObCYn-image.png) You will see a window that looks like this: [](https://wiki.joris.me/uploads/images/gallery/2024-06/1fcUi5JwCNYWLYEm-image.png) Enter the credentials I provided you, and check "Remember my credentials": [](https://wiki.joris.me/uploads/images/gallery/2024-06/36dYWpmAInyXqLqM-image.png) Then click **OK:** [](https://wiki.joris.me/uploads/images/gallery/2024-06/jVf4LVfqc8hyvThO-image.png) **And you're done!** You will probably be greeted by the drive: [](https://wiki.joris.me/uploads/images/gallery/2024-06/HvxifLsiYEE1hA8S-image.png) In your case, there won't be any existing files. # Mount a network drive (Linux NFS) ### Introduction This is a short manual on mounting network storage on Linux using NFS.This guide assumed that you have established a connection to my network; see [Connecting to my network](https://wiki.joris.me/books/network-storage/chapter/connecting-to-my-network) if you haven't already.
### Before we begin..I SHALL NOT BE LIABLE FOR ANY DAMAGES OR LOSSES ARISING FROM ANY USE OF THE NETWORK SHARE, INCLUDING ANY INTERRUPTIONS TO THE NETWORK SHARE, INCLUDING, BUT NOT LIMITED TO, ANY POWER OUTAGES, SYSTEM FAILURES, NETWORK ATTACKS, SCHEDULED OR UNSCHEDULED MAINTENANCE, OR OTHER INTERRUPTIONS.
**YOU** are responsible for keeping enough backups of your data**.**
**Recommended** reading: [https://www.backblaze.com/blog/the-3-2-1-backup-strategy/](https://www.backblaze.com/blog/the-3-2-1-backup-strategy/)
With that out of the way, let's begin! ### Installing dependencies We need NFS client tools to mount a drive. #### On Debian ``` sudo apt install nfs-common ``` #### On Arch Linux ``` sudo pacman -S nfs-utils ``` ### Mount a volume I have a separate domain used for resolving machines and services on my homelab. Take the following script and fill it out with your parameters. ```bash #!/bin/bash POOL=alpha # Leave as-is unless told otherwise. SHARE=joris # <-- Put your name here, in lower case. MOUNT=/mnt # <-- Write where you want to mount it. sudo mount truenas.storage.jorislab.nl:/mnt/$POOL/$SHARE $MOUNT ```And we're done! Enjoy!
# Accessing storage directly Guides on using Rclone to access storage directly, no mounting involved. # Accessing a share (rclone + SMB) ### Introduction This guide teaches you how to access a network share using **rclone** via the **SMB** protocol.This guide assumed that you have established a connection to my network; see [Connecting to my network](https://wiki.joris.me/books/network-storage/chapter/connecting-to-my-network) if you haven't already.
### Before we begin..I SHALL NOT BE LIABLE FOR ANY DAMAGES OR LOSSES ARISING FROM ANY USE OF THE NETWORK SHARE, INCLUDING ANY INTERRUPTIONS TO THE NETWORK SHARE, INCLUDING, BUT NOT LIMITED TO, ANY POWER OUTAGES, SYSTEM FAILURES, NETWORK ATTACKS, SCHEDULED OR UNSCHEDULED MAINTENANCE, OR OTHER INTERRUPTIONS.
**YOU** are responsible for keeping enough backups of your data**.**
**Recommended** reading: [https://www.backblaze.com/blog/the-3-2-1-backup-strategy/](https://www.backblaze.com/blog/the-3-2-1-backup-strategy/)
With that out of the way, let's begin! ### Prerequisites - A Linux machine; - A working [WireGuard](https://wiki.joris.me/books/network-storage/page/connecting-via-wireguard) or [Tailscale](https://wiki.joris.me/books/network-storage/page/connecting-via-tailscale) connection to my homelab; - The following three strings: - The **share name**; - The **username** for SMB authentication; - The **password** for SMB authentication. ### Installing dependencies We only really need to install `rclone`. #### On Debian ```bash sudo apt install rclone ``` #### On Arch Linux ```bash sudo pacman -S rclone ``` ### Adding the remote ```bash $> rclone config Current remotes: Name Type ==== ==== unrelated1 http unrelated2 smb # ..bla bla.. e/n/d/r/c/s/q> n # Choose a name for your remote: name> example_smb # A very long list appears, you can ignore it. # Just write: Storage> smb # Enter this host exactly: Option host. host> truenas.storage.jorislab.nl # Enter your first name, in lower case. For example: Option user. user> joris # Port number: default port> # press Enter # Use a password? Yes. Option pass. y/g/n> y Enter the password: password: # Paste the password you were given. Confirm the password: password: # Paste it again. # No specific domain domain> # press Enter Edit advanced config? y/n> n # No # Save the remote. Keep this "example" remote? y/e/d> y # yes # You should now land back at the start. # Write 'q' to exit e/n/d/r/c/s/q> q ``` ### Testing the remote After exiting the interactive CLI, you should now be able to run: ```bash # Format:It might seem odd to write 'example' as path here. The format is `
And we're done! Enjoy!