Operation
Operation
The Riversoft® STCP Gemini API and Riversoft STCP Gemini Server can run as services managed by systemd or directly from the command line.
Services
| Component | systemd service |
|---|---|
| Riversoft STCP Gemini API (includes the Portal) | stcpgemini-api |
| Riversoft STCP Gemini Server | stcpgemini-server |
systemctl start stcpgemini-api
systemctl start stcpgemini-serverCheck that the status shows running:
systemctl status stcpgemini-api
systemctl status stcpgemini-serverStart the API before the Server. The Server needs an instance created in the Portal.
Command line
Running from the command line is useful in containers, where the process must run in the foreground as the main process.
Riversoft STCP Gemini API
stcprestapi -lite -p 33070 \
-config /usr/local/stcpgemini-api/configs/config.json \
-webapp /usr/local/stcpgemini-api/portal/app \
-c <certificate> -k <private-key>In test environments without TLS, replace -c and -k with -ns.
With -lite, the API itself serves the Portal files. All options are in the Command reference.
Warning
Choose between disabling TLS (-ns) or enabling it with -c and -k together. Do not combine -ns with -c/-k.
Riversoft STCP Gemini Server
/usr/local/bin/stcpserver /usr/local/stcp/configs/stcpserver.config.jsonThe stcpserver options override the equivalent configuration file parameters. See the Command reference.
Containers
- Keep the process in the foreground so the orchestrator (Docker, Kubernetes, etc.) can track the container lifecycle.
- Do not force Riversoft STCP Gemini Server daemon mode (
-F). - Install Riversoft STCP Gemini Rename in the same image as Riversoft STCP Gemini Server when using routing.
- Use the API
-init-dband-init-db-fileoptions only during the initial installation, never in normal execution.