Linux installer¶
iopix-install.sh is one self-extracting file of about 200 KB (the app without models). It is attached to every release.
Install¶
As root on the target machine:
sh iopix-install.sh --photos /srv/photos --digikam-db /srv/digikamDB
It then:
- unpacks the app into
/opt/iopix/app, - installs the system packages iopix needs (Python with venv, ffmpeg, exiftool, libheif, the MariaDB client) with apt, dnf, zypper or pacman,
- creates the Python environment and installs the packages,
- downloads the models for the features you choose,
- creates the admin account,
- writes the settings to
/opt/iopix/app/iopix.env, with the data in/opt/iopix/data, - installs and starts a systemd service called
iopix, running as theiopixuser on port 8600.
A sudoers rule lets the service user run exactly systemctl restart iopix, so Update now in the app works.
Options¶
| Option | Meaning |
|---|---|
--photos PATH |
the photo folder |
--digikam-db PATH |
the folder with digikam4.db |
--mysql HOST:PORT/DB:USER:PASSWORD |
digiKam on MariaDB/MySQL instead |
--iopix-db sqlite or HOST:PORT/DB:USER:PASSWORD |
where iopix keeps its own database |
--features search,places,objects,ocr,captions |
the AI features; none for browsing only |
--captions |
all features, including photo descriptions |
--admin NAME:PASS |
the admin account |
--prefix, --data |
where the app and its data go |
--port, --host |
where it listens (default 8600, all addresses) |
--user |
the service user |
--read-only |
browsing only |
--no-service |
do not install the systemd service |
--no-system-deps |
do not install system packages |
--yes |
take every default |
--help |
list everything |
To keep passwords off the command line, set IOPIX_ADMIN=NAME:PASS and IOPIX_MYSQL=HOST:PORT/DB:USER:PASSWORD in the environment instead.
Upgrading¶
Running the installer again upgrades the code and keeps the data folder and the settings file. So does ./update.sh in /opt/iopix/app, or Update now in the app.