detached 27e453c

web-sign-in.md RawHistoryFolder

Web sign-in

Visitors read public repositories. The owner signs in to see private ones, review and merge. A session lasts 12 hours.

Two ways in

  • One-time link: ermite web login (admin token or a token with every scope) prints a link valid once, for 60 seconds. Use it the first time.
  • Passkey: press "Sign in with a passkey" on /-/login. Add one from /-/passkeys while signed in. Up to 20.

The cookie is Secure: plain http works only on localhost.

Passkey requirements

ERMITE_PUBLIC_URL must be https (or http://localhost) with a host name, not an IP. A passkey only works on the name it was registered for. On http://127.0.0.1:… passkeys are off (the log says passkeys disabled).

Manage sessions

ermite web passkey list
ermite web passkey remove <id>
ermite web logout --all

Removing a passkey, logout --all, or revoking a token with every scope signs out every device. If you lose every device, ermite web login still works.

source
1# Web sign-in
2
3Visitors read public repositories. The owner signs in to see private ones, review and merge. A session lasts 12 hours.
4
5## Two ways in
6
7- **One-time link**: `ermite web login` (admin token or a token with every scope) prints a link valid once, for 60 seconds. Use it the first time.
8- **Passkey**: press "Sign in with a passkey" on `/-/login`. Add one from `/-/passkeys` while signed in. Up to 20.
9
10The cookie is `Secure`: plain `http` works only on localhost.
11
12## Passkey requirements
13
14`ERMITE_PUBLIC_URL` must be `https` (or `http://localhost`) with a **host name, not an IP**. A passkey only works on the name it was registered for. On `http://127.0.0.1:…` passkeys are off (the log says `passkeys disabled`).
15
16## Manage sessions
17
18```sh
19ermite web passkey list
20ermite web passkey remove <id>
21ermite web logout --all
22```
23
24Removing a passkey, `logout --all`, or revoking a token with every scope signs out every device. If you lose every device, `ermite web login` still works.

Keyboard shortcuts

Single-key shortcuts are on. ctrl k and esc work whatever this says.

ctrl k :
go to a section, branch, tag, file or repository
?
this list
j k
move the row cursor down / up
enter
open the row under the cursor; on Files, a directory opens or closes in place
↑ ↓ ← → home end
in the file tree (focus on a row): previous / next row, close / open a directory or go to its parent / first entry, first / last row. They never open a file
l h
on Files: open a directory or a file / close a directory or go up to its parent, then to the parent page. Elsewhere: into the side panel (on a merge request, its files) / back to the content; there j k move between its controls
g g G
first / last row
/
filter the list; on Files, find a file anywhere in the repository (esc clears, enter opens the best match)
b
switch branch or tag
g s g f g c g b g m g i g r g a
tabs: summary, files, commits, branches & tags, merge requests, issues, releases, actions (when available)
g h
home
w
wide mode: use the whole width of the screen, or not (remembered)
y
copy a permalink pinned to the commit
d u x
diff: split / unified / collapse or expand all
e E
diff: the whole file in view / every file, with the lines the hunks hide
n
merge request: next note in the diff
esc
close a dialog, leave a field

Branches 4

Tags 45

↑↓ moveenter openesc close