Install the Unmeshed Server Locally on Linux

Use the Unmeshed CLI install-server command to install a self-managed Unmeshed server on a Linux machine.

Before running the installer, prepare:

• A Linux machine with systemd
• The Unmeshed CLI available on the machine
• PostgreSQL available and reachable from the server
• Nginx installed and running
• DNS or hostname configured for the server
• TLS certificate and key files already created on the server
• Download links for the required binary and archive files from the Unmeshed team

The --source option points to a local directory that contains the installer inputs.

Required files:

Server templates are bundled in the CLI. Do not place server templates in the source directory.

Create install.properties in the source directory with these properties:

• postgres_host
• postgres_user
• postgres_password
• hostname
• tls_cert_crt_path
• tls_cert_key_path
• user_id
• smtp_host
• smtp_port
• smtp_user
• smtp_password
• project_name
• available_memory

Example:

The --installdir option sets where Unmeshed server files are installed.

Example:

The installer extracts:

• JDK into <installdir>/jdk
• Deno into <installdir>/denobin
• Server binaries into <installdir>
• UI files into <installdir>/uihtmls

Run the command from a shell with the permissions needed to write to the install directory, create a systemd service, write Nginx configuration, and run setup SQL.

The installer:

• Validates the required archives
• Validates install.properties
• Validates TLS certificate and key paths
• Validates the database connection
• Validates that Nginx is running
• Installs binaries and configuration files
• Creates the systemd service
• Runs setup SQL
• Writes the Nginx configuration

Check the Unmeshed service:

Check Nginx:

Then open the site using the configured hostname:

To remove a local server install, stop and remove the systemd service first:

If Java processes from the install are still running, stop them before removing files:

Drop all tables from the target PostgreSQL database. Set connection details through your shell, .pgpass, or another approved credential method before running the command.

Confirm the public tables are removed:

Remove the install directory:

• Missing archives: confirm all required files are present in the --source directory.
• Invalid TLS paths: confirm tls_cert_crt_path and tls_cert_key_path point to existing files on the server.
• Database connection failure: confirm postgres_host, credentials, network access, and PostgreSQL permissions.
• Nginx not running: start Nginx and rerun the installer.
• Non-empty install directories: extraction stops when target directories already contain files. Use a clean install directory or move existing files before retrying.