Souvenarium NAS Docker
The complete package installs the Souvenarium server on a NAS Synology, UGREEN or TerraMaster compatible with Docker Compose and 64-bit Linux. It includes PHP/Apache, MariaDB, configuration files, guide and images Intel/AMD x86-64 ready to import. On ARM64, build the image on the NAS with the provided Dockerfile; this architecture remains to be validated on the hardware.
Installation
- Install the container manager for your NAS: Container Manager on Synology, Docker on UGREEN, Docker Engine and the Docker manager available on your version of TerraMaster TOS.
- Download the full ZIP from this file and extract it to a NAS folder, for example
docker/souvenarium. Also keep hidden files and all subfolders. - Copy
.env.examplein.env. ReplaceSOUVENARIUM_MEDIA_PATHby the absolute path of a existing folder containing your media, for example/volume1/Mediaon Synology. Respect the case. The paths depend on the volume and sharing of your NAS. - Grant the account used by the container the rights to reading files and accessing folders, including their parents. By default, PHP identity uses UID 33 / GID 33. In
.env, you can enter the digital identifiers of an authorized account withSOUVENARIUM_UIDandSOUVENARIUM_GID. The media is mounted as read-only. - On Intel/AMD x86-64, import the archive
images/*.tar.gzin the image manager. It contains Souvenarium and MariaDB. Then create a Docker project withdocker-compose.prebuilt.yml: No building or image uploading is necessary. To build on the NAS, especially on ARM64, choosedocker-compose.ymland build the project with Internet access. If the manager does not load.env, add its variables into the project. - Start the project. Wait until database and souvenarium are healthy. initialize, stopped with code 0, finished normally: it prepares the private passwords. MariaDB is configured automatically.
- Open
http://ADRESSE-DU-NAS:8090, choose the language, server name and administrator password. No SQL identifier to enter. You can adapt the port in.envand use the NAS reverse proxy for HTTPS.
Add your folders: Docker paths and rights
As of kit 0.1.59, the test remote folder button in the application checks for actual directory access on the NAS. A window displays the result and can be closed immediately to cancel the search. Cached information remains available when the NAS or storage is temporarily unreachable. Install the new kit while retaining your volumes and your .env.
Souvenarium works in a Docker container. It only sees folders that you mounted from the NAS Docker manager. The site can neither create these montages nor give permissions on the NAS. Files remain on the NAS without copying.
| Example on the NAS | Docker destination | Path to enter in Souvenarium |
|---|---|---|
/volume1/Media |
/medias |
/medias |
/volume1/Media/Films |
Montage subfolder | /medias/Films |
/volume1/Media/Photos |
Montage subfolder | /medias/Photos |
In Folders → Add Folder, indicate /medias/Films, choose its category then scan. The form lists the settings and rights to configure. Mounting a parent folder exposes its subfolders at once.
To add another share, add a mount to the service souvenarium from the NAS manager, or modify its Compose file:
- type: bind
source: /chemin/reel/PhotosFamille
target: /photos
read_only: true
bind:
create_host_path: false
Recreate the container, then declare /photos in the site. A simple restart does not change the edits. Access denied is corrected in the permissions/ACL of the NAS: check the UID/GID, reading and parental access.
Connect the app
Create an access key from the server. In Souvenarium Android, Fire TV or Windows: Settings → My Sources → Locations → Add Server Souvenarium, then provide the server address and key. The media are broadcast in their original format, without transcoding.
Update and backup
Keep the same project name, your .env, the montages and the three volumes catalog, state, credentials. Replace the kit files, import the new images or rebuild, and then recreate the containers. Do not delete volumes or use docker compose down -v
for an update.
Back up all three volumes together and .env, project stopped during a copy of the volumes, as well as your media separately. A source temporarily unavailable retains its records and progress: restore its editing and rights, then scan.
Check download
Compare the footprint SHA-256 displayed on this sheet to that of the ZIP received. The package also includes fingerprints of its files and images. This delivery is tested under Linux x86-64; the interfaces and ACLs of the physical NAS remain to be validated on each model.