Skip to content

Ubuntu Native Installation

Production Recommendation

systemd is the recommended native service manager for Linux production environments. For the full service installation, management, update, rollback, and troubleshooting guide, see Linux systemd Installation.

Runtime Directory Layout

```text /opt/iqvizyon/iqv-integration-api/ bin/ # Application binary deployment/ # Deployment metadata

/etc/iqvizyon/iqv-integration-api.env # Environment file

/var/log/iqvizyon/iqv-integration-api/ # Application logs

/var/lib/iqvizyon/iqv-integration-api/ backups/ # Pre-update backups ```

Quick Installation

Using the Installer Script

bash sudo bash ./scripts/linux/service/install.sh

This will create a dedicated service user, install the binary, register iqv-integration-api.service with systemd, and start the service.

Environment File

The installer never auto-creates an .env file. You must create it manually before running the installer:

bash sudo mkdir -p /etc/iqvizyon sudo cp ./config/.env.example /etc/iqvizyon/iqv-integration-api.env sudo chmod 600 /etc/iqvizyon/iqv-integration-api.env

Edit the file and set all required values — at minimum MONGODB_URI, AUTH_CLIENT_SECRET, AUTH_JWT_SECRET.

Service Management

bash sudo systemctl status iqv-integration-api.service sudo systemctl start iqv-integration-api.service sudo systemctl stop iqv-integration-api.service sudo systemctl restart iqv-integration-api.service

The binary also supports direct service commands:

bash ./iqv-integration-api service install --env-file /etc/iqvizyon/iqv-integration-api.env ./iqv-integration-api service status ./iqv-integration-api service start ./iqv-integration-api service stop ./iqv-integration-api service restart ./iqv-integration-api service uninstall

Verify

bash curl -s http://localhost:8080/health/live curl -s http://localhost:8080/health/ready

Both endpoints must return HTTP 200 for the installation to be considered successful.

Docker (Separate Deployment Type)

Docker is a separate deployment type from systemd. See Ubuntu Docker Installation and Docker Installation.

Further Reading