laplus 0.1.1-rc.14 → 0.1.1-rc.9
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +3 -39
- package/dist/bin.mjs +1 -23
- package/package.json +6 -6
package/README.md
CHANGED
|
@@ -35,40 +35,6 @@ npx laplus@latest --network # reachable from your phone on this netwo
|
|
|
35
35
|
npx laplus@latest --port 5000
|
|
36
36
|
```
|
|
37
37
|
|
|
38
|
-
## Keeping it running
|
|
39
|
-
|
|
40
|
-
On Linux with systemd, laplus can install itself as a background service for
|
|
41
|
-
your user — it starts at boot and survives you logging out of SSH.
|
|
42
|
-
|
|
43
|
-
```sh
|
|
44
|
-
npx laplus@latest service install --network
|
|
45
|
-
npx laplus@latest service status
|
|
46
|
-
npx laplus@latest service uninstall
|
|
47
|
-
```
|
|
48
|
-
|
|
49
|
-
The flags you pass to `service install` are the ones the service runs with.
|
|
50
|
-
|
|
51
|
-
## Pairing another device
|
|
52
|
-
|
|
53
|
-
A server started at boot has no terminal to print a pairing URL to, and any
|
|
54
|
-
server has only one startup credential. Mint a code whenever you need one:
|
|
55
|
-
|
|
56
|
-
```sh
|
|
57
|
-
npx laplus@latest auth pairing create
|
|
58
|
-
npx laplus@latest auth pairing create --ttl 1h --label "ipad"
|
|
59
|
-
npx laplus@latest auth pairing list
|
|
60
|
-
npx laplus@latest auth pairing revoke <id>
|
|
61
|
-
```
|
|
62
|
-
|
|
63
|
-
`create` prints the code, a URL, and **a QR code** — point a phone's camera at
|
|
64
|
-
it and there is nothing to type. Codes are single-use and last five minutes
|
|
65
|
-
unless `--ttl` says otherwise. Add `--base-url` when the address a device
|
|
66
|
-
reaches you at is a tunnel or a tailnet name this machine cannot discover, and
|
|
67
|
-
`--json` for a script.
|
|
68
|
-
|
|
69
|
-
This works against a server that is already running, and never has to find it:
|
|
70
|
-
a pairing code is a row in the database rather than server state.
|
|
71
|
-
|
|
72
38
|
`--network` turns the listener off loopback **for one run** and does not change
|
|
73
39
|
what the desktop app does next time it starts. Anything it can reach can drive
|
|
74
40
|
an agent on that machine, so the credential printed at startup is the whole of
|
|
@@ -82,11 +48,9 @@ Binaries are published for Windows x64, Linux x64 and arm64, and macOS on both
|
|
|
82
48
|
architectures. They arrive as `optionalDependencies`, so npm downloads exactly
|
|
83
49
|
one of them and skips the rest.
|
|
84
50
|
|
|
85
|
-
The Linux binaries are
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
On any platform not in that list, build the server yourself:
|
|
51
|
+
The Linux binaries are built against glibc 2.39, which rules out Debian 12 and
|
|
52
|
+
RHEL 9. Everywhere else — and on any platform not in that list — build the
|
|
53
|
+
server yourself:
|
|
90
54
|
|
|
91
55
|
```sh
|
|
92
56
|
git clone https://github.com/hoangvu12/laplus
|
package/dist/bin.mjs
CHANGED
|
@@ -4,7 +4,7 @@ import * as NodeChildProcess from "node:child_process";
|
|
|
4
4
|
import * as NodeFS from "node:fs";
|
|
5
5
|
import * as NodeURL from "node:url";
|
|
6
6
|
//#region package.json
|
|
7
|
-
var version = "0.1.1-rc.
|
|
7
|
+
var version = "0.1.1-rc.9";
|
|
8
8
|
//#endregion
|
|
9
9
|
//#region src/invocation.ts
|
|
10
10
|
/**
|
|
@@ -21,28 +21,6 @@ const HELP = `laplus — the laplus server, and the UI it serves.
|
|
|
21
21
|
npx laplus listen on 127.0.0.1:4773 and print a URL to open
|
|
22
22
|
npx laplus --network also listen off loopback, for a phone on this network
|
|
23
23
|
|
|
24
|
-
Pairing another device:
|
|
25
|
-
|
|
26
|
-
npx laplus auth pairing create a code, a URL, and a QR code to scan
|
|
27
|
-
npx laplus auth pairing list what is outstanding (never the secrets)
|
|
28
|
-
npx laplus auth pairing revoke <id>
|
|
29
|
-
|
|
30
|
-
--ttl 1h how long it lives (90s, 5m, 2h, 30d). Default 5 minutes
|
|
31
|
-
--label "ipad" what it is for, to recognise in the list
|
|
32
|
-
--base-url URL for a tunnel or tailnet this machine cannot see itself
|
|
33
|
-
--json for a script
|
|
34
|
-
|
|
35
|
-
Works against a server that is already running, including one started by the
|
|
36
|
-
service below — a pairing code is a database row, not server state.
|
|
37
|
-
|
|
38
|
-
Keeping it running (Linux with systemd):
|
|
39
|
-
|
|
40
|
-
npx laplus service install [flags] start at boot, and survive logging out
|
|
41
|
-
npx laplus service status whether one is installed, and up to date
|
|
42
|
-
npx laplus service uninstall stop it and take it off startup
|
|
43
|
-
|
|
44
|
-
The flags given to \`service install\` are the ones the service runs with.
|
|
45
|
-
|
|
46
24
|
Flags, all of them the server's own:
|
|
47
25
|
|
|
48
26
|
--port <n> the port to listen on (default 4773, LAPLUS_PORT)
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "laplus",
|
|
3
|
-
"version": "0.1.1-rc.
|
|
3
|
+
"version": "0.1.1-rc.9",
|
|
4
4
|
"description": "Run the laplus server and its UI without building either.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"repository": {
|
|
@@ -31,10 +31,10 @@
|
|
|
31
31
|
"node": ">=20"
|
|
32
32
|
},
|
|
33
33
|
"optionalDependencies": {
|
|
34
|
-
"@laplus/server-darwin-arm64": "0.1.1-rc.
|
|
35
|
-
"@laplus/server-darwin-x64": "0.1.1-rc.
|
|
36
|
-
"@laplus/server-linux-arm64": "0.1.1-rc.
|
|
37
|
-
"@laplus/server-linux-x64": "0.1.1-rc.
|
|
38
|
-
"@laplus/server-win32-x64": "0.1.1-rc.
|
|
34
|
+
"@laplus/server-darwin-arm64": "0.1.1-rc.9",
|
|
35
|
+
"@laplus/server-darwin-x64": "0.1.1-rc.9",
|
|
36
|
+
"@laplus/server-linux-arm64": "0.1.1-rc.9",
|
|
37
|
+
"@laplus/server-linux-x64": "0.1.1-rc.9",
|
|
38
|
+
"@laplus/server-win32-x64": "0.1.1-rc.9"
|
|
39
39
|
}
|
|
40
40
|
}
|