2.8 KiB
2.8 KiB
NextWorkspace
A self-hosted productivity suite for startups. One binary + Caddy + Authelia.
Architecture
app.nextwks.eu :443 auth.nextwks.eu :443
│ │
Caddy (TLS + forward auth) Caddy → Authelia :9091
│ │
├── /home/ → launcher page └── authelia-api :8080
├── /drive/* → OpenCloud :9100
├── /office/* → Euro Office :9200
├── /erp/* → ERPNext :9300
├── /chat/* → Matrix :9400
├── /meet/* → Jitsi :9500
├── /mail/* → Alps :9600
├── /ai/* → Open WebUI :9700
└── /admin/* → Portainer :9800
- Caddy: Reverse proxy, TLS (auto LE), subdomain routing, forward auth to Authelia
- Authelia: OIDC provider, 2FA, identity store
- Binary: Go launcher + path-based reverse proxy to upstream apps
Quick Start (Bare VM)
# Download the script to your home folder
curl -o ~/nextwks.sh https://git.lohmar.co.uk/lexton-it/NextWks/raw/branch/main/tools/nextwks.sh
chmod +x ~/nextwks.sh
# Run the installer
sudo bash ~/nextwks.sh --install
Prompts for domain, TLS email, and admin credentials. Installs deps (Go, Podman, git),
clones repo to /tmp/nextwks-build/, builds binary, generates configs, deploys stack.
The script stays in ~/nextwks.sh for future updates.
Directory Layout
/opt/nextworkspace/ # Runtime (freshly populated on every deploy)
├── config/
│ ├── caddy/Caddyfile
│ ├── authelia/configuration.yml
│ ├── authelia/users_database.yml
│ └── nextworkspace/{config,apps}.yaml
├── data/
│ ├── caddy/ (certs + runtime)
│ └── authelia/ (database)
├── compose/stack.yaml
├── www/ (landing page)
├── lng/ (translations)
└── nextworkspace (static Go binary)
/opt/backup/ # Secrets vault (survives --destroy)
├── .env
└── certificates/
/tmp/nextwks-build/ # Ephemeral build dir (git clone --depth 1)
Operations
# Smart update (pull, build, copy, restart)
sudo bash ~/nextwks.sh --update
# Full redeploy (tear down, rebuild from scratch with saved secrets)
sudo bash ~/nextwks.sh --destroy
Workflow (Development)
- Edit code in your clone.
- Bump
VERSION, updateCHANGELOG.md. git commit -m "message" && git tag v$(cat VERSION) && git push origin main --tags- On the server:
sudo bash ~/nextwks.sh --update
The script clones fresh from git every time — no stale repos, no permissions issues.
Version
Current: 0.1.0.0032 — see CHANGELOG.md