​
Overview

Standalone deployment is ideal for development environments or small-scale production setups. This guide walks you through running Linqra components individually with their required backing services.

​
Prerequisites

Before proceeding, ensure you have:
  1. Set up all required environment variables (Environment Variables Guide)
  2. Docker and Docker Compose installed on your system
  3. Access to the Linqra project repository

​
Infrastructure Components

Linqra’s standalone deployment requires several backing services:
  • Redis: Rate limiting and temporary data storage
  • MongoDB: Application resilience data
  • PostgreSQL: Keycloak data storage
  • Keycloak: Authentication and authorization
While we use Keycloak with PostgreSQL by default, you can configure any compatible Identity Provider.

​
Launch Infrastructure Services

Start the backing services using Docker Compose: 
cd ~/IdeaProjects/Linqra/

/usr/local/bin/docker compose -f docker-compose.yml -p Linqra up
For local development, we provide pre-configured JKS files (self-signed certificates). For production deployments, you must generate your own certificates.

​
Configure Identity Provider

After services are running:
  1. Access Keycloak at http://localhost:8281
  2. Follow our Keycloak Configuration Guide to set up:
    • Realms
    • Clients
    • Roles
    • Scopes

​
Deploy Application Components

After setting up the infrastructure services, you’ll need to build and deploy the Linqra application components.

​
Build JAR Files

Ensure you’re in the Linqra root directory: 
pwd
The output should show your root directory, for example: 
/Users/mehmetsen/IdeaProjects/Linqra
Build the application components using Maven: 
mvn clean package
This command will create the following JAR files:
ApplicationJar FileType
api-gatewayLiteGateway.jarGateway
discovery-serverDiscoveryService.jarDiscovery
The JAR files will be created in their respective target folders within each component’s directory.

​
Run JAR Files

After building the JARs, you’ll need to start each component in the correct order.

​
Run the JAR Files from Terminal

​
EUREKA SERVER

  1. Start Eureka discovery-server by going to the target folder:
cd ~/IdeaProjects/Linqra/discovery-server/target/
  1. Run the jar file along with the truststore jks file:
java -Djavax.net.ssl.trustStore="$EUREKA_TRUST_STORE" -Djavax.net.ssl.trustStorePassword="$EUREKA_TRUST_STORE_PASSWORD" -jar DiscoveryService.jar
  1. Check the Eureka discovery-server endpoint:
https://localhost:8761/

​
GATEWAY

  1. Go to the api-gateway target folder:
cd ~/IdeaProjects/Linqra/api-gateway/target
  1. Run the jar file along with the truststore jks file:
java -Djavax.net.ssl.trustStore="$GATEWAY_TRUST_STORE" -Djavax.net.ssl.trustStorePassword="$GATEWAY_TRUST_STORE_PASSWORD" -jar LiteGateway.jar
Note that we are not simply using ‘java -jar FileName.jar’ because SSL requires the truststore parameters to be provided on the command line. These parameters: 
-Djavax.net.ssl.trustStore="$CLIENT_TRUST_STORE" -Djavax.net.ssl.trustStorePassword="$CLIENT_TRUST_STORE_PASSWORD"
are necessary for establishing secure SSL connections between services. Without them, the applications would fail with SSL handshake errors.

​
Run Client Applications

After setting up the core services, you can deploy client applications that integrate with the Linqra gateway.

​
Prepare Client Services

First, ensure you’ve downloaded the example client applications from their respective GitHub repositories. For each client application, you’ll need to:
  1. Enable the environmental variables in your terminal:
source ~/.zshrc
  1. Build the application JAR files:
mvn clean package

​
Run Inventory Service

Navigate to the inventory service project: 
cd ~/IdeaProjects/linqra_inventory_service
Build the application: 
mvn clean package
Navigate to the target directory: 
cd target
Run the jar file with SSL configuration: 
java -Djavax.net.ssl.trustStore="$CLIENT_TRUST_STORE" -Djavax.net.ssl.trustStorePassword="$CLIENT_TRUST_STORE_PASSWORD" -jar InventoryService.jar

​
Run Product Service

Navigate to the product service project: 
cd ~/IdeaProjects/linqra_product_service
Build the application: 
mvn clean package
Navigate to the target directory: 
cd target
Run the jar file with SSL configuration: 
java -Djavax.net.ssl.trustStore="$CLIENT_TRUST_STORE" -Djavax.net.ssl.trustStorePassword="$CLIENT_TRUST_STORE_PASSWORD" -jar ProductService.jar
Now the last part. We need to start the web. Here is what we need to add: Assuming you are still at the root folder. go to the web root folder $ cd edge-service/ Then run the web $ sudo npm run dev Go to the https://localhost:3000/ If you see the “Your connection is not private” on the page, click the link “Proceed to localhost (unsafe)” to continue