Skip to main content

The admin page

http://<computer-address>:48651/admin is the one page where the server is configured. It adapts to a phone screen, so you can also use it from the phone. Log in with the server's password (see Installation for the first login).

From the home screen you reach the other screens with the buttons in one row: Account & Plus ›, Networks ›, Authorization ›, Advanced ›, Debug › and Projects ›. Save saves the home screen (it lights up only when something changed); Log Out ends this browser's session.

Home​

  • Photos folder — where the library's files live. Browse… opens a folder tree; you can only choose a folder inside a writable directory (see Advanced). Changing it needs a restart, and first asks what to do with the structure built on the old folder (below).
  • Album nesting limit, how deep albums may go (capped by your version).
  • Default export mode — what the web gallery's folder export does by default: ask each time, always copy or always symlink. A browser can override it for itself on /settings.
  • Upload into a folder and Server's upload mode — whether files added into an album that has a folder are copied or symlinked.
  • Rescue folder for hidden folders — the name of the folder used by the hidden-folders feature to keep files safe (default .hidden-rescued); you normally leave it as it is.

When something needs a restart, a Restart server button appears. The service comes straight back up.

Networks​

The device name shown in the phone's list of servers, the HTTP port (restart needed) and the mDNS service type, plus the computer's local and external addresses as the server sees them.

Authorization​

  • Change password — current password once, the new one twice (at least 8 characters). Every password field has a Show/Hide eye.
  • Recovery e-mail and Recovery PIN — see "Forgot the password?" below. You can set the PIN's length, Show current PIN and Refresh PIN (which makes the old one stop working).
  • Connected devices — one row per device (phone, desktop app, browser) with its last activity and Disconnect. A device with several sessions can be expanded; Disconnect all (or Disconnect others for the device you are using) closes them at once. Disconnecting frees a place when your version limits the number of devices.
  • SMTP (under the Advanced toggle on this screen) — an e-mail account the server itself can send recovery messages through. Not needed if the server is linked to an AISKSoft account (the account relays the message).

Forgot the password?​

On the login screen press Forgot password?, then Request a recovery PIN. The PIN is not shown on the page. It is printed in the server's log and sent to the recovery e-mail (if the server is linked to an AISKSoft account, or SMTP is set up). On the server computer you can also read it with node /opt/aiudtfs/scripts/show-pin.js run as the user the server runs as. Enter the PIN with a new password twice and press Reset password & continue.

Advanced​

  • Folders. Two lists decide which folders of the server computer the server may touch — Readable directories (it may look into them and bring files from them) and Writable directories (it may write there: the photos folder and export destinations must be inside one). Nothing outside the lists is reachable. Put a path in the field (or Browse…) and press Add to readable or Add to writable; Exclude switches an entry off without removing it; Remove deletes it. Press Save folders. Two checkboxes hide folders that start with a dot and folders owned by root from the folder trees.
  • Device info — version, the config file, the state folder, the photos folder, whether it runs under systemd.

Projects​

The albums are stored per photos folder (a project): changing the photos folder does not lose the old structure. When you press Save with a new folder, you choose:

  • Keep it as a separate project (named as you like) — switching back to that folder later brings it back untouched;
  • Take it along to the new folder — for when you moved or copied the photos folder itself; links to photos missing in the new place can be dropped;
  • Delete it.

The new folder's sub-folders become albums on the first start. The Projects screen lists all projects with Switch to it, Rename, Export (a .aipproj file with the albums and which photos are in them, not the photos themselves), Delete, and Import a project.

Debug​

A password-protected screen of diagnostics (debug mode, leftover "invisible" albums, the raw config file) meant for support. You do not need it day to day.