Skip to content

Commit 2fe2b8f

Browse files
committed
add technical details in short
1 parent 7144a9d commit 2fe2b8f

2 files changed

Lines changed: 20 additions & 0 deletions

File tree

docs/README.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,16 @@ That gives you three things at once:
1212

1313
And if you enable S3 exports, that time machine is not limited to the local disk. You also get an off-host disaster-recovery path for the day the whole VPS disappears.
1414

15+
> [!TIP]
16+
> **Technical details in short**
17+
> This tool sets up and orchestrates LXD, Traefik, Firewall, Virtual Networking, clustering, ZFS and backups.
18+
>
19+
> LXD is a systen that runs LXC containers and VMs (we are focused on containers). LXC containers are Linux system containers that sit conceptually between Docker-style application containers and traditional VMs. Like Docker containers, they are lightweight and share the host kernel using Linux namespaces and cgroups. Unlike typical Docker usage, LXC is often used to run a full OS-like userspace with init, package management, services, users, and networking, giving a VM-like administration experience without hardware virtualization overhead. They can also run inside ordinary cloud VMs because they do not require nested virtualization, though their isolation is not as strong as a true VM because the kernel is shared with the host.
20+
>
21+
> Using ZFS brings to the mix cheap hot snapshots that give "time machine" like experience with ability to "rewind" containers state in small increments together with exportable backups.
22+
>
23+
> Traefik is a reverse proxy that lives on host and can pass traffic in containers (in case of Terrarium - autoconfigurated via labels on containers). All this works on single node or in a cluster, that is built upon OVN and secure wireguard internal connections.
24+
1525
If you are new to Terrarium, start here:
1626

1727
- [Getting Started](getting-started/README.md)

docs/about.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -34,6 +34,16 @@ Terrarium brings enterprise-grade infrastructure features down to earth, combini
3434

3535
Terrarium is designed for tech enthusiasts who want the flexibility of a full server without having to become full-time DevOps engineers just to keep things secure and recoverable.
3636

37+
## Technical details in short
38+
39+
Terrarium sets up and orchestrates LXD, Traefik, Firewall, Virtual Networking, clustering, ZFS and backups.
40+
41+
LXD is a systen that runs LXC containers and VMs (we are focused on containers). LXC containers are Linux system containers that sit conceptually between Docker-style application containers and traditional VMs. Like Docker containers, they are lightweight and share the host kernel using Linux namespaces and cgroups. Unlike typical Docker usage, LXC is often used to run a full OS-like userspace with init, package management, services, users, and networking, giving a VM-like administration experience without hardware virtualization overhead. They can also run inside ordinary cloud VMs because they do not require nested virtualization, though their isolation is not as strong as a true VM because the kernel is shared with the host.
42+
43+
Using ZFS brings to the mix cheap hot snapshots that give "time machine" like experience with ability to "rewind" containers state in small increments together with exportable backups.
44+
45+
Traefik is a reverse proxy that lives on host and can pass traffic in containers (in case of Terrarium - autoconfigurated via labels on containers). All this works on single node or in a cluster, that is built upon OVN and secure wireguard internal connections.
46+
3747
## Where to Go Next
3848

3949
**If you're ready to get started:**

0 commit comments

Comments
 (0)