Deployment FAQ

Can I deploy to AWS/GCP/Azure?

Nexus OS runs anywhere Linux runs. Deploy the binary to any cloud VM, container, or serverless environment. The naos edge commands specifically target Cloudflare Workers for edge deployment.

How do I run Nexus OS in Docker?

FROM scratch
COPY naos /naos
COPY nexus.config.yaml /config/
WORKDIR /data
ENTRYPOINT ["/naos"]

The binary is statically linked, so FROM scratch works.

Can I run it in Kubernetes?

Yes. Use a StatefulSet with a PersistentVolumeClaim for the SQLite database:

apiVersion: apps/v1
kind: StatefulSet
metadata:
  name: nexus-os
spec:
  replicas: 1
  template:
    spec:
      containers:
        - name: nexus
          image: nexus-os:latest
          volumeMounts:
            - name: data
              mountPath: /data
  volumeClaimTemplates:
    - metadata:
        name: data
      spec:
        accessModes: ["ReadWriteOnce"]
        resources:
          requests:
            storage: 1Gi

How do I back up the database?

# Simple file copy (while naos is stopped)
cp data/nexus.db backup/nexus-$(date +%Y%m%d).db

# Online backup (while naos is running)
sqlite3 data/nexus.db ".backup backup/nexus.db"

What ports does Nexus OS use?

Only the dashboard port (default 4200). All other operations are CLI-based and don't require network ports.