---
title: "Open Source, Self-Hosted Homelab Remote Access - Octelium"
description: "A free and open source, self-hosted platform for homelab remote access and public hosting from behind NAT, with no port forwarding and no dynamic DNS."
canonical: "https://octelium.com/solutions/open-source-homelab"
---

Homelab

# Remote access and hosting for your homelab

Octelium is a free and open source, self-hosted zero trust access platform. It reaches everything on your home network from anywhere without forwarding a port, publishes what you want on your own domain with a managed certificate, and can deploy and host containerized applications itself.

[Install in minutes](https://octelium.com/docs/octelium/latest/overview/quick-install.md)[Live Demo](https://demo.octelium.com)[GitHub repo](https://github.com/octelium/octelium)

- Free and open source
- No port forwarding
- Runs on a small VM

The platform

## A unified secure access platform

A homelab gets the same platform an organization does. Each capability is described in detail below, in the same order.

1. [Unified access platform](https://octelium.com/docs/octelium/latest/overview/how-octelium-works.md)

   [One architecture for client-based zero-config VPN-like access over WireGuard and QUIC tunnels and clientless access over browsers for humans and OAuth2 access for workloads.](https://octelium.com/docs/octelium/latest/overview/how-octelium-works.md)

   [Read more](https://octelium.com/docs/octelium/latest/overview/how-octelium-works.md)
2. [L7-aware access control](https://octelium.com/docs/octelium/latest/management/core/policy.md)

   [Identity-based, application-layer aware ABAC access control with policy-as-code via CEL and OPA, applied on a per-request basis.](https://octelium.com/docs/octelium/latest/management/core/policy.md)

   [Read more](https://octelium.com/docs/octelium/latest/management/core/policy.md)
3. [Secretless access](https://octelium.com/docs/octelium/latest/management/core/service/secretless.md)

   [Dynamic secretless access where teams and AI agents access protected infrastructure without ever holding a credential.](https://octelium.com/docs/octelium/latest/management/core/service/secretless.md)

   [Read more](https://octelium.com/docs/octelium/latest/management/core/service/secretless.md)
4. [Unified identity management](https://octelium.com/docs/octelium/latest/management/core/user.md)

   [Teams, workloads and AI agents share the same model for identity management, access control, and auditing.](https://octelium.com/docs/octelium/latest/management/core/user.md)

   [Read more](https://octelium.com/docs/octelium/latest/management/core/user.md)
5. [Real-time visibility and auditing](https://octelium.com/docs/octelium/latest/management/core/visibility.md)

   [OpenTelemetry-native, real-time, application-layer-aware visibility and structured logging.](https://octelium.com/docs/octelium/latest/management/core/visibility.md)

   [Read more](https://octelium.com/docs/octelium/latest/management/core/visibility.md)
6. [GitOps-friendly management](https://octelium.com/docs/octelium/latest/management/core/service/managed-containers.md)

   [Octelium is administered like Kubernetes. Define your resources in YAML files, store them in a Git repository.](https://octelium.com/docs/octelium/latest/management/core/service/managed-containers.md)

   [Read more](https://octelium.com/docs/octelium/latest/management/core/service/managed-containers.md)

Client-based and clientless

## Reach it privately, publish it publicly, or both

Each resource is represented by a Service, which is served by an identity-aware proxy that abstracts away the network details of the upstream behind it. Where that upstream lives, and whether the internet can see it, are two separate fields.

- [A Service upstream can be an address that is only reachable from the side of a connected host, so a NAS, a Pi or a container at home is served over its own outbound tunnel with no port forwarded.](https://octelium.com/docs/octelium/latest/management/core/service/overview.md)
- [The same Service is reachable over a client-based WireGuard or QUIC tunnel with a stable private name, and clientlessly over HTTPS for a browser on a phone, a tablet or a television.](https://octelium.com/docs/octelium/latest/management/core/service/clientless.md)
- [Anonymous public access publishes an HTTP-based Service to the internet with authentication switched off, which turns the Cluster into a host for a personal site or a public API.](https://octelium.com/docs/octelium/latest/management/core/service/anonymous-access.md)

[See the homelab guides](https://octelium.com/docs/octelium/latest/management/guide/service/homelab.md)

Access control

## Layer-7 aware access control with policy-as-code

Access is authorized on a per-request basis, using CEL or Open Policy Agent, against the identity behind the request and the content of the request itself. Sharing one thing with someone does not share everything else.

- [Groups keep household, guests and your own automation on separate sets of resources, and Policies attach to a Service, a Namespace, a User or a Group.](https://octelium.com/docs/octelium/latest/management/core/policy.md)
- [Apply application-layer access control to protocol-specific attributes including HTTP requests, SSH users, Kubernetes operations, database users and queries, MCP methods and tools, and LLM operations and models.](https://octelium.com/docs/octelium/latest/management/core/service/dns.md)
- [Anonymous Services can enable anonymous authorization, which keeps them publicly reachable while still filtering on the request itself.](https://octelium.com/docs/octelium/latest/management/core/service/anonymous-access.md)

[Read about access control and Policies](https://octelium.com/docs/octelium/latest/management/core/policy.md)

Secretless access

## Keep upstream credentials out of users and workloads

Application-layer credentials are stored in the Cluster as Secrets and injected into the upstream connection once a request is authorized. Nothing has to be pasted into a bookmark, a script or a shared note.

- [Covers SSH passwords and private keys, PostgreSQL and MySQL passwords, HTTP API keys and access tokens, kubeconfigs and mTLS client certificates.](https://octelium.com/docs/octelium/latest/management/core/service/secretless.md)
- [Paid third-party APIs are covered as well, so a key you are billed for can be used by your own tools and by guests without being copied anywhere.](https://octelium.com/docs/octelium/latest/management/guide/service/http/zero-trust-saas-api.md)
- [Which upstream account and credential are used can be selected per request from identity, so your own devices and a guest reach the same Service with different privileges.](https://octelium.com/docs/octelium/latest/management/core/service/dynamic-config.md)

[Read about secretless access](https://octelium.com/docs/octelium/latest/management/core/service/secretless.md)

Identity

## One identity model for humans, workloads and AI agents

Human and workload Users share the same identity management, authentication, access control and visibility model. The machine serving your resources, the script that backs them up and the person watching a film are all identities in the same system.

- [GitHub OAuth2 works as an identity provider out of the box, as does any OpenID Connect or SAML 2.0 provider, including a self-hosted Keycloak, Authentik or Dex.](https://octelium.com/docs/octelium/latest/management/core/identity-providers.md)
- [Native FIDO2 and WebAuthn passkeys, TOTP and TPM 2.0 authenticators are built in, so a hardware key can be required without running a separate MFA service.](https://octelium.com/docs/octelium/latest/management/core/authenticator.md)
- [Scripts and automation authenticate with authentication tokens, OAuth2 client credentials or federated OIDC assertions, so nothing needs a stored password.](https://octelium.com/docs/octelium/latest/management/core/credential.md)
- [A locally hosted OpenAI-compatible inference server can be fronted by the LLM gateway mode exactly as a hosted provider would be.](https://octelium.com/docs/octelium/latest/management/guide/service/ai/remote-ollama.md)

[Read about identity providers](https://octelium.com/docs/octelium/latest/management/core/identity-providers.md)

Visibility and auditing

## Identity-aware visibility at the application layer

Emit structured, application-layer access logs in real time and export them through OpenTelemetry OTLP to the observability, analytics and SIEM systems your organization already operates.

- [Application-layer detail includes HTTP requests and responses, database queries, SSH session recordings, DNS question names, and LLM operations and token usage.](https://octelium.com/docs/octelium/latest/management/core/visibility.md)
- Logs are exported over OTLP, which fits whatever you already run at home, whether that is a Grafana stack, an OpenSearch instance or a single collector writing to disk.
- Because the Cluster is yours, the record of who reached what stays inside your own boundary rather than in a provider's console.

[Read about visibility and auditing](https://octelium.com/docs/octelium/latest/management/core/visibility.md)

Deployment and scale

## A platform that also deploys your applications

Run the Cluster on Kubernetes infrastructure you control, scale the data plane horizontally, manage resources declaratively, automate the platform through APIs and SDKs, and optionally deploy containerized Service upstreams with the Cluster itself.

- [Managed containers deploy, scale and serve a container image as the Service upstream, which covers a static site, a Next.js or Vite application or any small service, with no machine at home involved.](https://octelium.com/docs/octelium/latest/management/guide/service/http/nextjs-vite.md)
- [Public DNS records and TLS certificates for published Services are managed by the Cluster, so putting something on your own domain is not a separate certificate workflow.](https://octelium.com/docs/octelium/latest/install/cluster/dns.md)
- [Manage Cluster resources declaratively with YAML and GitOps workflows, including reproducible configuration through octeliumctl apply.](https://octelium.com/docs/octelium/latest/overview/management.md)

[Read the management guide](https://octelium.com/docs/octelium/latest/overview/management.md)

Homelab needs

## The things a homelab ends up needing, and what serves each

Most homelabs accumulate a tunnel, a reverse proxy, a certificate tool, a dynamic DNS client, an authentication portal and a pile of forwarded ports. These are the needs behind that, next to the mechanism in an Octelium Cluster that serves each one.

1. 01

   ### Reaching things at home from anywhere

   A connected host serves the upstream over its own outbound tunnel, so nothing is port forwarded, no dynamic DNS is needed and the router configuration is untouched. That works for a NAS, a Raspberry Pi, a container or a laptop.

   [Read more](https://octelium.com/docs/octelium/latest/management/core/service/overview.md)

2. 02

   ### Publishing something to the internet

   The very same Service can be published over HTTPS on your own domain, either behind authentication or anonymously for a personal site or a public API, with the public DNS record and the TLS certificate managed by the Cluster.

   [Read more](https://octelium.com/docs/octelium/latest/management/guide/service/homelab/website-api-hosting-nat.md)

3. 03

   ### Hosting the application itself

   There does not have to be a machine at home at all. Managed containers deploy, scale and serve a container image as the Service upstream, which covers a static site, a Next.js or Vite application or any small service.

   [Read more](https://octelium.com/docs/octelium/latest/management/guide/service/http/nextjs-vite.md)

4. 04

   ### Logging in without another password

   GitHub OAuth2 works as an identity provider out of the box, as does any OpenID Connect or SAML 2.0 provider, including a self-hosted Keycloak, Authentik or Dex that the Cluster can also serve.

   [Read more](https://octelium.com/docs/octelium/latest/management/guide/service/homelab/keycloak-helm-self-host.md)

5. 05

   ### Letting other people in, carefully

   Family, guests and your own automation can be separate Users in separate Groups with separate Policies, so sharing a media server does not also share the router, the NAS shell or the database.

   [Read more](https://octelium.com/docs/octelium/latest/management/core/policy.md)

6. 06

   ### Shell access to small devices

   The embedded SSH mode serves SSH from inside the octelium client itself, without a standalone SSH server on the host and without root privileges, which suits fleets of containers and small devices.

   [Read more](https://octelium.com/docs/octelium/latest/management/core/service/embedded-ssh.md)

7. 07

   ### Your own DNS, reachable remotely

   A DNS Service puts a home resolver such as Pi-hole behind identity and can authorize on the question name and record type, so ad filtering follows you off the home network.

   [Read more](https://octelium.com/docs/octelium/latest/management/guide/service/homelab/pihole.md)

8. 08

   ### A remote development environment

   A code server or a remote IDE endpoint is just another Service, reachable in a browser or over the tunnel, with the upstream credential held by the Cluster rather than typed into a bookmark.

   [Read more](https://octelium.com/docs/octelium/latest/management/guide/service/homelab/remote-vscode-code-server.md)

The point is not that each of these is hard on its own. It is that they are usually six separate pieces of software with six configurations, and here they are fields on the same resource.

On every Octelium Cluster

The same platform capabilities ship with every deployment, whichever way you use it.

- [OIDC & SAML 2.0 SSO](https://octelium.com/docs/octelium/latest/management/core/identity-providers.md)
- [Native FIDO2, TPM 2.0 & TOTP](https://octelium.com/docs/octelium/latest/management/core/authenticator.md)
- [OpenTelemetry auditing](https://octelium.com/docs/octelium/latest/management/core/visibility.md)
- [GitOps management](https://octelium.com/docs/octelium/latest/overview/management.md)
- [Policy-as-code with CEL & OPA](https://octelium.com/docs/octelium/latest/management/core/policy.md)
- [Managed containers](https://octelium.com/docs/octelium/latest/management/core/service/managed-containers.md)
- [Clientless BeyondCorp access](https://octelium.com/docs/octelium/latest/management/core/service/clientless.md)
- [Anonymous public access](https://octelium.com/docs/octelium/latest/management/core/service/anonymous-access.md)
- [gRPC API & SDKs](https://octelium.com/docs/octelium/latest/management/guide/sdk.md)

Questions

## Frequently asked

- What does it take to run this at home?

  The quick installer provisions a complete single-node Cluster, including Kubernetes itself, on one fresh Linux VM with 2 vCPUs, 2 GB of RAM and a domain you own. That is enough for personal and homelab use. The Cluster itself is normally on a cheap cloud VM with a public address, while the resources it protects stay at home behind NAT.

- Do I have to forward ports or run dynamic DNS?

  No. A Service upstream can be an address that is only reachable from the side of a connected client. That client runs octelium connect with the --serve or --serve-all flag and serves the resource to the Cluster over its own outbound tunnel, so nothing inbound is opened on the home network and no dynamic DNS record has to track a changing address.

- Can I host a public website with it?

  Yes. Anonymous public access publishes an HTTP-based Service to the internet with authentication and authorization switched off, which makes the Cluster a hosting platform for a personal site or a public API. Anonymous authorization can then still be enabled so the Service filters on path, method, headers and body content while staying publicly reachable.

- Is the enterprise package needed for personal use?

  No. Octelium is free and open source and complete on its own. The enterprise package adds capabilities such as a web console, SCIM provisioning and secret encryption at rest, and it is free for personal, homelab and evaluation use.

- Do I need to know Kubernetes?

  No. An Octelium Cluster runs on top of Kubernetes, but you do not need Kubernetes experience to install, operate or use it. Day-to-day management is a set of YAML resources and a single octeliumctl apply, in the same shape as the examples on this page.

- Can family members use it without installing anything?

  Yes. HTTP-based resources can be published clientlessly, so a media server or a dashboard opens in an ordinary browser on a phone, a tablet or a television after a normal sign-in. The octelium client is only needed for protocols a browser cannot speak, such as SSH, databases and generic TCP and UDP.

Keep reading

## Related solutions

### [ngrok alternative](https://octelium.com/solutions/ngrok-open-source-self-hosted-alternative.md)

[Publish local and private Services on your own domain and infrastructure, with optional identity-aware access control in front of them.](https://octelium.com/solutions/ngrok-open-source-self-hosted-alternative.md)

[Read more](https://octelium.com/solutions/ngrok-open-source-self-hosted-alternative.md)

### [Self-hosted PaaS](https://octelium.com/solutions/open-source-paas.md)

[Deploy, scale and serve containerized applications as Octelium Services with private, authenticated or anonymous access.](https://octelium.com/solutions/open-source-paas.md)

[Read more](https://octelium.com/solutions/open-source-paas.md)

### [WireGuard remote access VPN](https://octelium.com/solutions/wireguard-remote-access-vpn-foss.md)

[Zero-configuration WireGuard connectivity with a stable route, private dual-stack addressing and automatic private DNS.](https://octelium.com/solutions/wireguard-remote-access-vpn-foss.md)

[Read more](https://octelium.com/solutions/wireguard-remote-access-vpn-foss.md)

Get started

## Run Octelium on your own infrastructure

Install a self-hosted Cluster and start applying identity-aware access control to your Services.

[Quick install guide](https://octelium.com/docs/octelium/latest/overview/quick-install.md)[GitHub repo](https://github.com/octelium/octelium)[Homelab guides](https://octelium.com/docs/octelium/latest/management/guide/service/homelab.md)
