ByteBite Docs
Infrastructure

Infrastructure Overview

Orientation for ByteBite hosting, networking, deployment, and operations.

Infrastructure Overview

ByteBite runs as containerized applications on dedicated Hetzner hardware under Proxmox. Staging is active on BYTEBITE-APP-01. Production application infrastructure is not deployed — although production DNS records already point at the edge IP.

This section is the operational source of truth for hosting, networking, TLS, deployment, and day-two operations. Application tenancy behavior is documented in Tenancy & storefront; this section focuses on the platform that runs it.

Environment status

EnvironmentStatusNotes
LocalActiveDocker Compose + Traefik on developer machines
StagingActiveDokploy on BYTEBITE-APP-01 — verified 2026-09-08
ProductionNot deployedDNS exists; no production app stack
MailProvisioned, incompleteBYTEBITE-MAIL-01 network ready; Stalwart/SES not finished

Documentation labels facts as Verified, Configured, Planned, or Unknown where the distinction matters. See Environments for a full comparison.

High-level topology

Internet
  -> Cloudflare DNS (DNS-only, not proxied)
    -> edge.getbytebite.co (88.99.0.118)
      -> BYTEBITE-APP-01
        -> dokploy-traefik (Traefik v3.6.7, ports 80/443)
          -> Dokploy-managed routing + compose.deploy.yml Traefik labels
            -> api | storefront | dashboard | docs (Docker)
            -> Dokploy managed PostgreSQL (internal only)

Mail is planned on a separate VM (BYTEBITE-MAIL-01, 88.99.0.97). See Mail.

Component inventory

ComponentLocationStatusCanonical doc
Proxmox hostHetzner dedicated serverVerifiedCompute
BYTEBITE-APP-01VM 103, 88.99.0.118VerifiedCompute
BYTEBITE-MAIL-0188.99.0.97ProvisionedMail
DokployAPP VMVerified v0.30.5Dokploy
Traefik (dokploy-traefik)APP VMVerified v3.6.7Traefik
PostgreSQL 18Dokploy service on APP VMVerified, internal onlyDatabase
Application stackcompose.deploy.ymlVerified stagingDeployment
Cloudflare DNSExternalVerifiedDNS
MinIOLocal dev onlyActive locallyStorage
Stalwart / SES / B2PlannedMail, Storage

Domain inventory (staging)

All staging application records are DNS-only (grey cloud) in Cloudflare and resolve through edge.getbytebite.co88.99.0.118.

HostServiceRouting source
staging.getbytebite.coStorefrontDokploy UI
luigi.staging.getbytebite.coStorefrontDokploy UI
mario.staging.getbytebite.coStorefrontDokploy UI
dashboard.staging.getbytebite.coDashboardDokploy UI
api.staging.getbytebite.coAPIDokploy UI
docs.staging.getbytebite.coDocsDokploy UI
dokploy.getbytebite.coDokployDokploy
*.staging.getbytebite.coStorefront + /apicompose.deploy.yml Traefik labels

Wildcard DNS does not imply a tenant exists — tenant identity comes from the restaurant_domains table. See DNS and Architecture.

What is intentionally absent

Current architecture does not include Redis, BullMQ, Kubernetes, GraphQL, or microservice decomposition. These are non-goals for the current platform, not future promises.

Start here

QuestionPage
How does a request reach the storefront?Architecture
Local vs staging vs production?Environments
Deploy staging?Staging deployment
Validate after a change?Validation
What is still missing?Known gaps

On this page