Skip to content

Commit 1943e02

Browse files
Update readme (#68)
* Clean up * Added readme for gryffindor * Added readme and updated the directory structure
1 parent e392496 commit 1943e02

File tree

8 files changed

+110
-17
lines changed

8 files changed

+110
-17
lines changed

README.md

+17-17
Original file line numberDiff line numberDiff line change
@@ -16,16 +16,16 @@ I am a strong advocate for GitOps and using automations as much as possible,
1616
to be clear, not everything should be automated but everything that can remove
1717
waste (waste as an wasted time) should be automated as long as it is secure.
1818

19-
This repository is my Homelab in code, this repo is an repetentation on what I am
20-
running in my Homelab and how my Homelab is currently configured. This is both for
21-
my own documentation but also to help and inspire others that want to do the
22-
same.
19+
This repository is my Homelab in code, this repo is an repetentation on what I
20+
am running in my Homelab and how my Homelab is currently configured. This is
21+
both for my own documentation but also to help and inspire others that want to
22+
do the same.
2323

2424
> [!IMPORTANT]
25-
> Things will change and I am always trying out new things, so I have another repo
26-
> called homelab-archive where I move everything that I am no longer using but have
27-
> been running, so if there is something that you have seen here but doesn't exists
28-
> anymore then check in that repo, it should be there.
25+
> Things will change and I am always trying out new things, so I have another
26+
> repo called homelab-archive where I move everything that I am no longer using
27+
> but have been running, so if there is something that you have seen here but
28+
> doesn't exists anymore then check in that repo, it should be there.
2929
3030
## Background
3131

@@ -45,8 +45,8 @@ quick way out sometime)
4545

4646
## My Homelab
4747

48-
My Homelab is running Proxmox VE, I have run Proxmox pretty much since I decided to
49-
setup my Homelab and I love it!
48+
My Homelab is running Proxmox VE, I have run Proxmox pretty much since I
49+
decided to setup my Homelab and I love it!
5050

5151
> [!NOTE]
5252
> I hope to be able to setup more servers with Proxmox so I can experiment with
@@ -82,8 +82,8 @@ that Proxmox has to offer.
8282

8383
### Folder structure
8484

85-
I have built the structure in a way so I can easily find what I am searching for
86-
so first level is the project or application I am interested in, the second
85+
I have built the structure in a way so I can easily find what I am searching
86+
for so first level is the project or application I am interested in, the second
8787
level is the tools I have been using to setup the project/application for
8888
instance Terraform, Ansible or maybe Docker compose file.
8989

@@ -134,14 +134,14 @@ tutorial, and man I can say it has been an experiance.
134134

135135
### Some projects/applications looks out of date
136136

137-
Yes as times go I will try different applications and projects and might replace
138-
stuff I have run before for something else that I liked, but as this is
137+
Yes as times go I will try different applications and projects and might
138+
replace stuff I have run before for something else that I liked, but as this is
139139
documentation and history for me there will exists things that is outdated so
140140
I can go back and check how I did something if I ever want to set it up again.
141141

142142
## Contribute
143143

144-
Even if this is my own Homelab and I won't accept contribution dont heasitate to
145-
create a PR if there is something I could have done differently or if there is
146-
something that looks really wrong, I am still learning and all help is
144+
Even if this is my own Homelab and I won't accept contribution dont heasitate
145+
to create a PR if there is something I could have done differently or if there
146+
is something that looks really wrong, I am still learning and all help is
147147
appreciated.

gryffindor/1000-truenas/README.md

+43
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,43 @@
1+
# 1000-truenas - Main NAS
2+
3+
## Background
4+
5+
This VM is my main NAS that runs TrueNAS Scale.. YES, I am virtualizing my NAS
6+
and the reason for this is because I have tried running TrueNAS a the host VM
7+
before and then used the internal VM support for when I needed to run VM's for
8+
testing but due to the limitations that TrueNAS has for more advanced settings
9+
of VM's it is easier to runt Proxmox as the host OS and then virtualize TrueNAS
10+
with a lot of passthrough and it has worked great!
11+
12+
## VM setup
13+
14+
The entire VM setup is made using Terraform so look through the terraform
15+
directory to se the setup in more detail, but everything is configured to give
16+
as much realtime performance as possible like setting the CPU Type as host and
17+
passthrough hardware that is dedicated to the NAS like HBA and NIC to remove as
18+
much bottlenecks as possible that can occure when virtualizing a NAS.
19+
20+
## Structure
21+
22+
### Infrastructure
23+
24+
Here I store the IaC code that setups the infrastructure of the VM using
25+
Terraform, the provider I have used is linked below.
26+
27+
[bpg/proxmox provider](https://registry.terraform.io/providers/bpg/proxmox/0.73.1)
28+
29+
### Configuration
30+
31+
Currently TrueNAS Scale is so new that no good tool has yet been released to
32+
manage the configuration of TrueNAS so currently everything is managed manually
33+
from the GUI, as soon as I find a stable and reliable tool that I can use I
34+
will add it to this directory.
35+
36+
## Future plans
37+
38+
My end goal is to build a smaller server that can focus on only running the NAS
39+
because even if running the NAS as a VM has worked great, I want to separate
40+
it to another machine to reduce the risk of single point of failure if
41+
something happens when doing my testing of other things and because my family
42+
is also using the NAS for things like watching movies or storing personal
43+
backups of images and files I want to reduce the risk of downtime for the NAS.

gryffindor/1000-truenas/configuration/.keep

Whitespace-only changes.

gryffindor/README.md

+50
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,50 @@
1+
# Gryffindor - NAS/HomeLab
2+
3+
## Background
4+
5+
Gryffindor is my main server that I have built my entire homelab infrastructure
6+
around. It currently works as a dual purpose server to both run as a NAS and as
7+
a HomeLab. In the long run I want to separate the NAS to a dedicated machine,
8+
but for now this has to do.
9+
10+
The server runs Proxmox as it's OS and everything that can be managed using
11+
IaC tools is managed by code so it is easy to reproduce and also keeps an
12+
history of what is been changed over the time.
13+
Some support is still missing in Proxmox or in the tools to be managed using
14+
IaC tools but once it is added I will update the code with the support, one
15+
example is to setup ACME Certification using ACME plugins ex. Cloudflare. It
16+
is possible to setup self-signed certificates but not when using ACME Plugins
17+
(or I have not just yet figured out how to do it).
18+
19+
## Structure
20+
21+
In this folder I have separated each VM with it's own directory, so if you want
22+
to know more about a specific VM then go into that directory for the specific
23+
VM and read the README.md file for the specific VM.
24+
25+
## Hardware
26+
27+
Here is a list of what hardware the server is running. Some hardware is
28+
salvaged parts from my main PC and will be replaced over time.
29+
30+
* Asrock X99 WD
31+
* Intel Xeon E5-2699v3 18 Core's 36 Threads
32+
* Hyper 212 EVO CPU Cooler
33+
* 88GB non-ecc RAM
34+
* LSI 9207-8i IT P20 HBA (passthrough to NAS VM)
35+
* 6x3TB WD Red (connected to HBA)
36+
* 2x120GB Samsung SSD (Running in RAID-z1 for the OS)
37+
* TP-Link gigabit NIC
38+
* Asus Strix GTX980
39+
* Corsair 750W PSU
40+
* Fractal Define R5
41+
42+
Some future plans for this machine is:
43+
44+
* Replace the PSU to a more reliable PSU.
45+
* Replace the non-ecc RAM with ECC ram for better stability.
46+
* Add another GPU that can act as a main GPU for Proxmox due to the CPU is
47+
missing iGPU support.
48+
* Move everything to an rack mountable case.
49+
* Replace the GTX980 with something bigger so I can test AI services.
50+

0 commit comments

Comments
 (0)