Signing in
11 answers
Passwords, authenticator apps, recovery codes and getting back in.
Looking for something specific
The searchable index covers all 326 answers at once and filters as you type.
15 Sign in for the first time
- Open the address the installer printed, such as
https://203.0.113.10:7443. - Your browser warns that the connection is not private. That is expected: the server made its own certificate during installation. Continue past it.
- Type your username and password and press Continue.
- Set up an authenticator app when asked, then type the six digit code.
- Save the recovery codes it shows you. They are shown once and never again.
16 Set up an authenticator app
Any authenticator works: Google Authenticator, Microsoft Authenticator, 1Password, Aegis or anything else that scans a standard code.
- Open the app and choose to add an account.
- Point it at the square code on screen.
- Type the six digit number it starts showing.
If the phone cannot scan, type the line of characters underneath the code into the app by hand. It is the same thing in a different form.
17 I lost my phone and I have recovery codes
Sign in with a recovery code instead of a six digit code. Each one works once. Then go to My Account and set up your new phone from there.
18 I lost my phone and I have no recovery codes left
Nobody inside the software can help, because the software is the thing you cannot reach. Somebody with root on any node runs this:
sudo docker exec nginx-fleet-manager \
python -m app.reset_admin --list
sudo docker exec nginx-fleet-manager \
python -m app.reset_admin alice --reset-totp
Every use is written to the audit log as coming from the console, which is exactly the sort of thing that should stand out later.
19 Get a fresh set of recovery codes
My Account, then Recovery codes. Making a new set cancels every old code immediately, including any you have written down. Do it when you are down to one or two, and save the new list before you close the page.
20 Move my authenticator to a new phone
While the old phone still works: go to My Account and set up the new one from there. You get a fresh code to scan, and the old phone stops working once you confirm.
If the old phone is already gone, sign in with a recovery code first, then do the same thing.
21 Change my password
My Account. You need your current password as well as the new one. Changing it ends your other sessions, so a browser you left signed in somewhere else stops working. That is deliberate, and it is the quickest thing to do if you think somebody else has your password.
22 See where I am currently signed in
My Account lists your sessions. If you see something you do not recognize, change your password, which ends all of them at once, and tell whoever looks after security where you work.
23 Why is a button grayed out?
You are almost certainly looking at the standby node. Changes are made on the active one. Check the top right of the screen for which node you are on, and open the other one.
24 Reach the management screen by name instead of by IP
Put a site in front of it, the same way you would any other application.
- Make a pool with one member:
127.0.0.1port 7443. Turn on TLS and turn off certificate verification, since it uses its own self signed certificate and the traffic never leaves the box. - Add
NFM_ROOT_PATH=/lbto.envand restart the container, so every link it writes includes the prefix. - Make a site for
lb-01.example.comwith a path of/lbpointing at that pool. Leave the strip prefix setting off. - Get a certificate for that name and turn on https.
Keep the allowlist set to your office networks. The name being public and the screen being reachable are two different things.
25 Log out everybody at once
There is no single button for it. Turning an account off ends that person's sessions immediately. For everybody, restarting the manager container on each node clears sessions across the fleet.