Install · Commands

Server commands

All commands of the orionplace server tool. Run them with sudo; sudo orionplace without a command opens a menu with the common tasks.

How it works

The tool keeps its records in /etc/orionplace, the nginx sites in /etc/nginx/orionplace and the storefronts in /srv/orionplace. Two commands never change the server at the same time: if one is running, the next one stops and asks you to wait.

Commands

CommandWhat it does
sudo orionplaceMenu with the common tasks.
sudo orionplace setupInstalls Node.js, nginx and certbot and prepares the server. Safe to run again.
sudo orionplace domain add [domain]Adds a domain with an HTTPS certificate and connects it to a storefront and your backend.
sudo orionplace domain listDomains with storefront, backend, days left on the certificate and HTTPS status.
sudo orionplace domain check <domain>Checks the DNS, certificate, backend, storefront and HTTPS answer of one domain.
sudo orionplace domain remove <domain>Removes a domain; with --delete-certificate its certificate too.
sudo orionplace cert listExpiry dates of the certificates.
sudo orionplace cert renew [--force]Renews the storefront certificates that expire within 30 days; --force renews all of them now. Certificates of other sites are left alone.
sudo orionplace app install <nuxt|react|svelte> [name]Creates a storefront from its npm package in /srv/orionplace, connects your backend and domain, gets the certificate and runs the storefront as a service.
sudo orionplace app versions <nuxt|react|svelte>Published versions of a storefront package.
sudo orionplace app listInstalled storefronts with type, port, state, backend and folder.
sudo orionplace app status <name>Service state of a storefront.
sudo orionplace app logs <name>Last log lines of a storefront.
sudo orionplace app start|stop|restart <name>Starts, stops or restarts the service of a storefront.
sudo orionplace app remove <name>Stops and removes the service of a storefront. Its files stay; its domains show a placeholder.
sudo orionplace statusNode.js, nginx, certbot, storefronts and domains at a glance.
sudo orionplace updateDownloads the latest version of the tool.
orionplace helpAll commands and options.

Update the tool

The tool downloads its latest version from orionmarket.place:

bash
sudo orionplace update

Files

Domains: /etc/orionplace/domains. Storefronts: /etc/orionplace/apps. nginx sites: /etc/nginx/orionplace, one file per domain, written by the tool; nginx loads them through orionplace.conf in the folder nginx.conf includes (conf.d, or http.d on Alpine), or through orionplace-loader.conf next to nginx.conf. Certificates: /etc/letsencrypt/live. Storefront services: /etc/systemd/system, or /etc/init.d on Alpine. Storefront logs: journalctl, or /var/log/orionplace on Alpine.