Install the DEB package
Download the package that matches your architecture and install it with the system package manager. The packaged application is placed under /opt/soft/webcool, with the launcher available as /usr/local/bin/webcool. Keep configuration and data paths documented before migrating the machine.
sudo apt install ./webcool_*.deb
webcoolPrepare storage and permissions
Create a dedicated data path
Use a mounted data disk such as /srv/webcool-data, rather than filling the root filesystem.
Assign the correct owner
The account running webcool needs read and write access to the library, but should not receive unrestricted access to unrelated system directories.
Test mounts after reboot
If storage comes from another disk or NAS, verify the mount is available before the service starts and fail safely when it is not.
Restrict network access
Allow the service port only from the trusted LAN subnet with UFW or your firewall of choice. Test from a second device before adding remote access. For internet use, place the service behind a trusted VPN or a properly maintained HTTPS reverse proxy.
Least privilege: a file service should not run as root for everyday operation. Limit the service account to the folders and network interfaces it actually needs.
Plan startup, AI packages, and recovery
- Record the package, configuration, data, and log locations.
- Configure supervised startup and check it after reboot.
- Monitor storage capacity, disk health, memory, and process status.
- Install optional AI runtimes only for the restoration features you use.
- Back up both the content library and configuration, then test restoration.
Frequently asked questions
Which Ubuntu version should I use?
Use a currently supported Ubuntu release that matches the available package and your hardware architecture.
Why can webcool browse one folder but not another?
The service account probably lacks directory traversal or read/write permission. Fix ownership and permissions narrowly instead of running the service as root.
Do AI tools work on every server?
Availability and speed depend on the package, platform, installed model runtime, memory, and compute hardware.