From 1758396d8c1bd9b916b9aeef5fc2f34fe4500606 Mon Sep 17 00:00:00 2001 From: WebX11 SysOp Date: Thu, 5 Nov 2026 20:52:26 +0100 Subject: docs(newos4): per-OS clone guide (Linux, macOS, Windows, Termux, iOS) Served at https://newos.webx11.duckdns.org/usage.html from docs/usage.html in this repo, so the page, the mirror and the README share one source. Covers the four failure modes that actually bite: CRLF on Windows (core.autocrlf), missing CA bundles, cloning into /sdcard from Termux (FUSE has no POSIX permissions), and the read-only 403 on push. --- docs/usage.html | 204 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 204 insertions(+) create mode 100644 docs/usage.html (limited to 'docs/usage.html') diff --git a/docs/usage.html b/docs/usage.html new file mode 100644 index 0000000..d8bb495 --- /dev/null +++ b/docs/usage.html @@ -0,0 +1,204 @@ + + + + + +Getting newOS4 — Linux, macOS, Windows, Termux + + + + +
+ +

Getting newOS4

+

One public, read-only repository. Clone it on Linux, macOS, Windows or Android — no account, +no key, no token.

+ +
+
git clone https://newos.webx11.duckdns.org/newos4.git
+

+ One URL for every platform. …/newos4 (without .git) also works — that is cgit's + dumb-HTTP path and it is slower; use the .git form.

+
+ + + + + + + + +
What you get
Contents310 files, ~2.3 MB, full history (182 commits), MIT licence
Latest tagv4.6.146 — see refs
Writesnone. git-receive-pack answers 403; there is no SSH endpoint
Private datastripped from every commit before publication — see Scope
Reading itrendered README · file tree · history
+ +

Linux

+
+
+

Install git, if it is missing

+
# Debian / Ubuntu / Mint
+sudo apt update && sudo apt install -y git
+
+# Fedora / RHEL
+sudo dnf install -y git
+
+# Arch / Manjaro
+sudo pacman -S --noconfirm git
+
+# Alpine
+sudo apk add git
+
+
+

Clone and check

+
git --version                       # 2.30 or newer is fine
+git clone https://newos.webx11.duckdns.org/newos4.git
+cd newos4
+git log --oneline -3
+git describe --tags                 # v4.6.146
+
+
+

A distro without CA roots fails with +SSL certificate problem: install ca-certificates. Behind a proxy, add +git config --global http.proxy http://host:port.

+ +

macOS

+
xcode-select --install      # ships git (Apple's build is older but sufficient)
+# or: brew install git
+
+git clone https://newos.webx11.duckdns.org/newos4.git
+cd newos4 && git describe --tags
+

If git opens a licence prompt, run +sudo xcodebuild -license accept once. The clone lands in your working directory; nothing is +installed system-wide.

+ +

Windows

+
winget install --id Git.Git -e --source winget
+
+# new PowerShell window, then:
+git clone https://newos.webx11.duckdns.org/newos4.git
+cd newos4
+git log --oneline -3
+
+ Set this before cloning on Windows: + git config --global core.autocrlf false. The repository is served from a Linux host — a CRLF + checkout silently rewrites every shell script and JS file, and they stop working when copied back. Linux + and macOS default to false; Windows installers default to true. +
+

Without winget: git-scm.com/download/win +→ “Git for Windows” → next-next-finish → “Git Bash” gives you the same commands as above. WSL2 works too and +needs no special handling.

+ +

Android — Termux

+

Termux is a real Linux userland, so the Linux instructions apply almost unchanged. Three things differ:

+
+
+

1. Install git in Termux

+
pkg update && pkg upgrade -y
+pkg install -y git ca-certificates
+git --version
+
+
+

2. Clone into Termux's own home, not shared storage

+
cd ~
+git clone https://newos.webx11.duckdns.org/newos4.git
+cd newos4
+git log --oneline -3
+
+ Do not clone into /sdcard or ~/storage/…: that filesystem is + FUSE-mounted without POSIX permissions, and git dies with + error: unable to write file … Permission denied halfway through. Clone to + ~/newos4 and copy files out afterwards. If you need shared storage access at all, run + termux-setup-storage once and grant the prompt. +
+
+
+

3. Keep the session alive for a big clone

+
termux-wake-lock          # stops Android from freezing the download
+git clone --depth 1 https://newos.webx11.duckdns.org/newos4.git
+termux-wake-unlock
+

+ --depth 1 fetches the newest tree only — much faster on mobile data. You lose history; + re-clone without it later if you want the full 181 commits.

+
+
+

Editing on the phone: pkg install nano or +pkg install micro, then nano newos4/README.md. Termux's own git is a standard build, so +git status, git diff and git log behave exactly as on a laptop.

+ +

iPhone / iPad

+

a-Shell (free) includes git: run the same +git clone command. Working Copy is a GUI alternative that can +also clone a public HTTPS repository without an account.

+ +

Updating later

+
cd newos4
+git pull --ff-only          # the mirror only ever fast-forwards
+git describe --tags         # new tag appears when a release is published
+

The mirror is refreshed daily at 05:50 UTC and a new release tag is +minted on each publish. Nothing you do locally can be pushed back — see below.

+ +

Verifying what you got

+
git -C newos4 rev-parse --short HEAD      # tip commit
+git -C newos4 tag -l                      # v4.6.146
+git -C newos4 ls-files | wc -l            # 310
+du -sh newos4/.git                       # ~2.3 MB
+ +

Scope, and why you cannot push

+

The mirror is generated from a private monorepo by +admin/scripts/publish-newos4.py: it keeps only the spaces/newos4 subtree, removes +private paths (data/, backups/, .hermes/, credentials, profile JSON) from +every commit, and scans all blobs for secrets before anything is pushed. That is why the history +starts where it does: earlier private commits were never published.

+

Pushing is disabled at three levels — no git-receive-pack route on the vhost, 403 on +the advertisement, and http.receivepack=false in the repository. If you want to report a bug or ask +for a change, email darkmotox11@gmail.com; do not send patches to a +repository that cannot accept them.

+ +

Troubleshooting

+ + + + + + + + +
SymptomCause and fix
Repository not foundWrong URL. Use https://newos.webx11.duckdns.org/newos4.git — the host is newos., not git.
SSL certificate problemMissing CA bundle → apt install ca-certificates / pkg install ca-certificates
Could not resolve hostOffline, or a corporate DNS that drops wildcard subdomains
403 on git pushExpected — the mirror is read-only by design
Clone stalls on mobilegit clone --depth 1, and termux-wake-lock on Android
Scripts arrive with CRLFgit config --global core.autocrlf false, then re-clone
+ + + +
+ + -- cgit v1.2.3