docs: not finished yet
This commit is contained in:
kellervater
155
README.md
155
README.md
@@ -1,13 +1,162 @@
|
||||
# 🏗️ HomeRacker - The universal modular rack building system
|
||||
[What's it for?](#use-cases) | [How does it work?](#how-it-works) | [Free & OpenSource](#open-standard)
|
||||
|
||||
[](https://makerworld.com/en/@kellervater)
|
||||
|
||||
|
||||
HomeRacker is a fully modular rack building system for virtually any "racking needs" (Server Rack, shoe rack, book shelf, you name it).
|
||||
HomeRacker is a fully modular 3D-printable rack building system for virtually any "racking needs" (Server Rack, shoe rack, book shelf, you name it).
|
||||
|
||||
This repo contains the respective `scad` files for all fully customizable models as well as the documentation for the entire project which seeds the page https://homeracker.org.
|
||||
|
||||
You can find all parametric and non-parametric models as well as the `f3d` files (like the `HomeRacker - Core`) on [Makerworld](https://makerworld.com/en/@kellervater)).
|
||||
|
||||
> [!NOTE]
|
||||
> The basic HomeRacker system is also referred to as `HomeRacker - Core`. Free for everyone to use.
|
||||
|
||||
# Table of Contents
|
||||
- [Use Cases](#use-cases)
|
||||
- [Open Standard](#open-standard)
|
||||
- [Basic building blocks](#basic-building-blocks)
|
||||
- [Supports](#supports)
|
||||
- [Connectors](#connectors)
|
||||
- [Spring Pins](#spring-pins)
|
||||
- [Why the name?](#why-the-name)
|
||||
- [📜 Licensing](#-licensing)
|
||||
- [Todos](#todos)
|
||||
|
||||
# Use Cases
|
||||
Initially I created HomeRacker, because I wasn't happy with any of the creations available on the Internet.
|
||||
Some where too specific by only allowing certain devices which the original creator owned. Other's "only" allowed a 10" standard but no deviations and still the need for adapters to fit the 10" standard.
|
||||
As I am currently (April 2025) starting my homelab journey I wanted a solution which is so modular that it can grow with the demands of an ongoing homelab journey without having to buy the next bigger rack or to change concepts after a while because the originally intended concept doesn't work out in the long run.
|
||||
|
||||
|
||||
|
||||
As it is my nature to overengineer everything, I came up with a more generic solution to serve ANY "racking needs". Be it to build a small rack for a few Raspberry Pi's, a 10" standard rack for HomeLabs or even a 19" standard rack (still working on that though). You can even create book shelfs, shoe racks or combine all of the above in an abomination of a rack.
|
||||
|
||||
To give you an idea of how this may look like (10" rack, half constructed PI mini-rack, book shelf):
|
||||
|
||||
|
||||
Aside from the basic [building blocks](#basic-building-blocks) above's racks also contain following parts:
|
||||
* 10" Rack
|
||||
* HomeRacker - 10" Rackmount Kit (Todo: link to Makerworld Model) for standard height units
|
||||
* Raspi 5 Mount Kit
|
||||
* Vertical Mount Adapter for HomeRacker
|
||||
* Front-Panel for 10" racks
|
||||
* Rackmount Ears for the Switch. These are fully customizable rackmount ears which I created as [openSCAD file](./models/rackmount_ears/rackmount_ears.scad). You can customize it directly [here](https://makerworld.com/en/models/1259227-fully-customizable-rackmount-ears#profileId-1283271).
|
||||
* HomeRacker Airflow Kit (Todo: link to Makerworld Model) which consists of
|
||||
* Front/Back panels
|
||||
* Side panels
|
||||
* Bottom/Top panels with air intake/exhaust grid and bores for standard fans (80/92/120mm)
|
||||
* Shelf (You can build any shelf)
|
||||
|
||||
# Features
|
||||
The `HomeRacker - Core` features:
|
||||
* Full modularity - Due to the support-connector system you can scale out in any direction. Only limit is the material strength
|
||||
* 3D-printable - The entire core system is printable and no additional tools are required to assemble it. No need to include batteries here
|
||||
* No supports - Not a single part of the core system needs printed supports.
|
||||
* OpenSource - Feel free to build your own adapters and/or use it in all your personal or commercial projects (see [Open Standard](#open-standard) and [Licensing](#-licensing) for details).
|
||||
|
||||
## How it works
|
||||
### Assembly Basics
|
||||
|
||||
|
||||
|
||||
The assembly process for the `HomeRacker - Core` system is straightforward and requires no additional tools. Follow these steps:
|
||||
|
||||
1. **Prepare the Components**: Download the HomeRacker-Core (Todo: insert link) and print all parts required to assemble your specific rack. Ensure the parts are clean and free of debris.
|
||||
2. **Connect Supports and Connectors**: Attach the connectors to the supports as per your desired configuration. The modular design allows for flexibility in size and shape.
|
||||
3. **Secure with Spring Pins**: Use the spring pins to lock the connectors and supports in place. This ensures stability and prevents accidental disassembly. Due to their quadratic profile they can be inserted horizontally or vertically. Make sure they are fully inserted. Normally you hear a click when that's the case. You can use a bit of force but not too much.
|
||||
4. **Add Additional Features**: (not part of the core system) Depending on your use case, attach shelves, panels, or other accessories to complete your rack.
|
||||
|
||||
> [!NOTE]
|
||||
> **PRO-Tip**: If you need to disassemble your rack for whatever reason and the spring pin fits so tight, that you would rip out your fingernail pulling on it, just press a pin from the other side onto the pin in question. This should help pulling it out.
|
||||
|
||||
## Tech Specs
|
||||
> [!NOTE]
|
||||
> To inspect the actual values I highly recommend checking out the somewhat okISH original fusion (`f3d`) files which are ALWAYS part of my Makerworld uploads. I always parameterize my designs so they can scale without problem.
|
||||
|
||||
The entire system revolves around 4 simple numbers:
|
||||
1. 15mm - This is the so called `base_unit` or `base_length` in all my models. It ressembles the side length of each side of a support. x and y are fixed to 15mm and z is always a multiple of this depending on the desired unit count of a support
|
||||
2. 4mm - Is the side length of each end of a spring pin and it's corresponding holes in the supports.
|
||||
3. 2mm - Is the strength of the connector walls.
|
||||
|
||||
> These numbers (except for the tolerance) where purely arbitrary because I assumed they made sense. There wasn't any static calculation behind it.
|
||||
|
||||
### Supports
|
||||
|
||||
|
||||
### Connectors
|
||||
|
||||
|
||||
### Spring Pins
|
||||
|
||||
|
||||
|
||||
## Open Standard
|
||||
I created the `HomeRacker - Core` system to be an open standard which every maker can build upon with (almost) no strings attached (see [Licensing](#-licensing) for details).
|
||||
|
||||
|
||||
|
||||
Therefore I highly encourage all of you to build your own creations building upon the HomeRacker system.
|
||||
If you let me know about your projects, I will feature them here on this site and cross-link them on MakerWorld (provided they get my "totally" objective stamp of approval). Just [create an issue](https://github.com/kellervater/homeracker/issues/new) here if you want to be featured!
|
||||
|
||||
## Contributing
|
||||
As described in the
|
||||
|
||||
# Why the name?
|
||||
Following about four hours of research, I discovered that all my initial naming ideas (such as UniRack, OpenRack, etc.) were already in use by other creators or companies.
|
||||
|
||||
So, HomeRacker is a bit of a tongue-in-cheek creation. It combines the practical ability to build racks for homelabs with a more humorous, if slightly concerning, potential to literally become a "homewrecker" when the joy of building racks consumes too much time that could be spent with loved ones.
|
||||
|
||||
# 📜 Licensing
|
||||
|
||||
> [!NOTE]
|
||||
> tl;dr - Use it for ANY purpose (even commercial), but don't forget to give credit and to share it the same way!
|
||||
|
||||
* The source code in this repository is licensed under the `MIT License` (see [LICENSE](./LICENSE)).
|
||||
* All 3D models and creative assets (in /models/) are licensed under the `CC BY-NC 4.0 License` (see [/models/LICENSE](./models/LICENSE)).
|
||||
* All 3D models and creative assets (in /models/) are licensed under the `CC BY 4.0 License` (see [/models/LICENSE](./models/LICENSE)).
|
||||
|
||||
These licenses apply ONLY to the `HomeRacker - Core` system and the customizable rackmount ears. So, basically all content of this repository.
|
||||
|
||||
> [!IMPORTANT]
|
||||
> All other models and derivates of HomeRacker I created may be released under less permissive licenses. But this will be disclosed at the respective models on MakerWorld.
|
||||
|
||||
# Tests
|
||||
Of course I tested stuff... It took me 4 months from the idea to the first release here.
|
||||
Look at the prototypes:
|
||||
|
||||
## Disclaimer
|
||||
> [!WARNING]
|
||||
> This project is provided "as is" without any warranty of any kind. Use it at your own risk. The creators are not responsible for any damage, injury, or loss caused by the use of this project or its components. Always ensure proper safety precautions when assembling or using the HomeRacker system.
|
||||
|
||||
Aside from the scary warning above, I need to mention, that due to the high modularity of this system combined with limited time and resources I was of course not able to test every combination of filaments, printers, print-settings, room conditions (temperature, humidity) or to do extensive load-bearing tests.
|
||||
|
||||
What I want to say:
|
||||
I feel like the model turned out to be really nice and versatile. That's why I shared it in the first place.
|
||||
But since I do not have control over the manufacturing conditions of any consumer of this model, I cannot give any guarantees on how your specific print will turn out in the end. There are just too much variables which not even the best model design can compensate for. (Writing this feels a bit like an upfront apology... seems like I'm a people pleaser)
|
||||
|
||||
## How I tested
|
||||
My setup is as follows:
|
||||
* a room temperature between 17 and 25°C
|
||||
* Humidity levels between 29% and 36% (depends on when I'm doing my laundry)
|
||||
* A BambuLab X1C printer
|
||||
* Exclusively BambuLab filament (haven't tried others yet)
|
||||
* PLA Matte (I love the charcoal color. Looks so silky)
|
||||
* PLA Basic
|
||||
* ABS
|
||||
* mostly I used the Textured PEI plate. It just works (provided you regularly clean it using Isopropyl alcohol). For the rest of the time I tried out the Cold Plate Super Track (it's nice but very hard to get your prints of the plates when it cools)
|
||||
|
||||
All above's filaments can be be combined in any possible way (just make sure you do flow calibration before using new filaments. First ABS print turned out horribly just because I forgot to click the calibration checkbox).
|
||||
E.g.: you could print a connector in ABS, a support in PLA Matte and a spring pin in PLA and they will just fit when being assembled.
|
||||
|
||||
> 🛠️ **Btw:** I am not affiliated with Bambu in any way besides uploading my models to MakerWorld and occasionally making use of their Exclusive Model program. But they don't pay me for naming their products anywhere else (I wish 😉).
|
||||
|
||||
# Todos
|
||||
* [ ] Rename Building blocks in f3d (did bad translations from german to english there)
|
||||
* [ ] Release models on MakerLab
|
||||
* [ ] HomeRacker - Core (under above's license, non-exclusive)
|
||||
* [ ] HomeRacker - 10" Rackmount Kit (exclusive)
|
||||
* [ ] HomeRacker - Pi5 Mount Kit (exclusive)
|
||||
* [x] Customizable Rackmount Ears
|
||||
* [ ] HomeRacker - Airflow Kit (exclusive)
|
||||
* [ ] HomeRacker - Shelf
|
||||
* [ ] Can we even call it a standard yet?
|
||||
@@ -1,4 +1,4 @@
|
||||
remote_theme: pages-themes/architect@v0.2.0
|
||||
title: HomeRacker
|
||||
description: "The universal modular rack building system"
|
||||
description: "A printable modular rack building system"
|
||||
author: "kellervater"
|
||||
|
||||
|
Before Width: | Height: | Size: 1.0 MiB After Width: | Height: | Size: 1.0 MiB |
BIN
img/real_life_example.jpg
Normal file
BIN
img/real_life_example.jpg
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 2.7 MiB |
@@ -1,4 +1,4 @@
|
||||
Attribution-NonCommercial-ShareAlike 4.0 International
|
||||
Attribution-ShareAlike 4.0 International
|
||||
|
||||
=======================================================================
|
||||
|
||||
@@ -54,18 +54,18 @@ exhaustive, and do not form part of our licenses.
|
||||
|
||||
=======================================================================
|
||||
|
||||
Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International
|
||||
Public License
|
||||
Creative Commons Attribution-ShareAlike 4.0 International Public
|
||||
License
|
||||
|
||||
By exercising the Licensed Rights (defined below), You accept and agree
|
||||
to be bound by the terms and conditions of this Creative Commons
|
||||
Attribution-NonCommercial-ShareAlike 4.0 International Public License
|
||||
("Public License"). To the extent this Public License may be
|
||||
interpreted as a contract, You are granted the Licensed Rights in
|
||||
consideration of Your acceptance of these terms and conditions, and the
|
||||
Licensor grants You such rights in consideration of benefits the
|
||||
Licensor receives from making the Licensed Material available under
|
||||
these terms and conditions.
|
||||
Attribution-ShareAlike 4.0 International Public License ("Public
|
||||
License"). To the extent this Public License may be interpreted as a
|
||||
contract, You are granted the Licensed Rights in consideration of Your
|
||||
acceptance of these terms and conditions, and the Licensor grants You
|
||||
such rights in consideration of benefits the Licensor receives from
|
||||
making the Licensed Material available under these terms and
|
||||
conditions.
|
||||
|
||||
|
||||
Section 1 -- Definitions.
|
||||
@@ -84,7 +84,7 @@ Section 1 -- Definitions.
|
||||
and Similar Rights in Your contributions to Adapted Material in
|
||||
accordance with the terms and conditions of this Public License.
|
||||
|
||||
c. BY-NC-SA Compatible License means a license listed at
|
||||
c. BY-SA Compatible License means a license listed at
|
||||
creativecommons.org/compatiblelicenses, approved by Creative
|
||||
Commons as essentially the equivalent of this Public License.
|
||||
|
||||
@@ -108,7 +108,7 @@ Section 1 -- Definitions.
|
||||
|
||||
g. License Elements means the license attributes listed in the name
|
||||
of a Creative Commons Public License. The License Elements of this
|
||||
Public License are Attribution, NonCommercial, and ShareAlike.
|
||||
Public License are Attribution and ShareAlike.
|
||||
|
||||
h. Licensed Material means the artistic or literary work, database,
|
||||
or other material to which the Licensor applied this Public
|
||||
@@ -122,15 +122,7 @@ Section 1 -- Definitions.
|
||||
j. Licensor means the individual(s) or entity(ies) granting rights
|
||||
under this Public License.
|
||||
|
||||
k. NonCommercial means not primarily intended for or directed towards
|
||||
commercial advantage or monetary compensation. For purposes of
|
||||
this Public License, the exchange of the Licensed Material for
|
||||
other material subject to Copyright and Similar Rights by digital
|
||||
file-sharing or similar means is NonCommercial provided there is
|
||||
no payment of monetary compensation in connection with the
|
||||
exchange.
|
||||
|
||||
l. Share means to provide material to the public by any means or
|
||||
k. Share means to provide material to the public by any means or
|
||||
process that requires permission under the Licensed Rights, such
|
||||
as reproduction, public display, public performance, distribution,
|
||||
dissemination, communication, or importation, and to make material
|
||||
@@ -138,13 +130,13 @@ Section 1 -- Definitions.
|
||||
public may access the material from a place and at a time
|
||||
individually chosen by them.
|
||||
|
||||
m. Sui Generis Database Rights means rights other than copyright
|
||||
l. Sui Generis Database Rights means rights other than copyright
|
||||
resulting from Directive 96/9/EC of the European Parliament and of
|
||||
the Council of 11 March 1996 on the legal protection of databases,
|
||||
as amended and/or succeeded, as well as other essentially
|
||||
equivalent rights anywhere in the world.
|
||||
|
||||
n. You means the individual or entity exercising the Licensed Rights
|
||||
m. You means the individual or entity exercising the Licensed Rights
|
||||
under this Public License. Your has a corresponding meaning.
|
||||
|
||||
|
||||
@@ -158,10 +150,9 @@ Section 2 -- Scope.
|
||||
exercise the Licensed Rights in the Licensed Material to:
|
||||
|
||||
a. reproduce and Share the Licensed Material, in whole or
|
||||
in part, for NonCommercial purposes only; and
|
||||
in part; and
|
||||
|
||||
b. produce, reproduce, and Share Adapted Material for
|
||||
NonCommercial purposes only.
|
||||
b. produce, reproduce, and Share Adapted Material.
|
||||
|
||||
2. Exceptions and Limitations. For the avoidance of doubt, where
|
||||
Exceptions and Limitations apply to Your use, this Public
|
||||
@@ -229,9 +220,7 @@ Section 2 -- Scope.
|
||||
Rights, whether directly or through a collecting society
|
||||
under any voluntary or waivable statutory or compulsory
|
||||
licensing scheme. In all other cases the Licensor expressly
|
||||
reserves any right to collect such royalties, including when
|
||||
the Licensed Material is used other than for NonCommercial
|
||||
purposes.
|
||||
reserves any right to collect such royalties.
|
||||
|
||||
|
||||
Section 3 -- License Conditions.
|
||||
@@ -276,6 +265,7 @@ following conditions.
|
||||
reasonable to satisfy the conditions by providing a URI or
|
||||
hyperlink to a resource that includes the required
|
||||
information.
|
||||
|
||||
3. If requested by the Licensor, You must remove any of the
|
||||
information required by Section 3(a)(1)(A) to the extent
|
||||
reasonably practicable.
|
||||
@@ -287,7 +277,7 @@ following conditions.
|
||||
|
||||
1. The Adapter's License You apply must be a Creative Commons
|
||||
license with the same License Elements, this version or
|
||||
later, or a BY-NC-SA Compatible License.
|
||||
later, or a BY-SA Compatible License.
|
||||
|
||||
2. You must include the text of, or the URI or hyperlink to, the
|
||||
Adapter's License You apply. You may satisfy this condition
|
||||
@@ -307,8 +297,7 @@ apply to Your use of the Licensed Material:
|
||||
|
||||
a. for the avoidance of doubt, Section 2(a)(1) grants You the right
|
||||
to extract, reuse, reproduce, and Share all or a substantial
|
||||
portion of the contents of the database for NonCommercial purposes
|
||||
only;
|
||||
portion of the contents of the database;
|
||||
|
||||
b. if You include all or a substantial portion of the database
|
||||
contents in a database in which You have Sui Generis Database
|
||||
@@ -415,6 +404,7 @@ Section 8 -- Interpretation.
|
||||
that apply to the Licensor or You, including from the legal
|
||||
processes of any jurisdiction or authority.
|
||||
|
||||
|
||||
=======================================================================
|
||||
|
||||
Creative Commons is not a party to its public
|
||||
|
||||
Reference in New Issue
Block a user