Merge pull request #2718 from akhilmhdh/doc/infisical-package

docs: added new docs for infisical package installation instructions

docs/mint.json

@@ -313,6 +313,13 @@
             "self-hosting/deployment-options/kubernetes-helm"
           ]
         },
+        {
+          "group": "Linux Package",
+          "pages": [
+            "self-hosting/deployment-options/native/linux-package/installation",
+            "self-hosting/deployment-options/native/linux-package/commands-configuration"
+          ]
+        },
         "self-hosting/guides/upgrading-infisical",
         "self-hosting/configuration/envars",
         "self-hosting/configuration/requirements",

docs/self-hosting/deployment-options/native/linux-package/commands-configuration.mdx

@@ -0,0 +1,38 @@
+---
+title: "Configurations"
+description: "Learn how to configure and manage the Infisical Linux package"
+---
+
+## Configuration Overview
+
+All configuration for the Infisical Linux package is managed through a single file called `infisical.rb`, located in the `/etc/infisical` directory. 
+This file defines all necessary settings, including encryption keys, database connections, and environment-specific settings.
+
+<Info> After making any changes to the `infisical.rb` file, always run `infisical-ctl reconfigure` to apply them. </Info>
+
+### Example Configuration
+
+```ruby infisical.rb
+# Important: Replace these values with secure keys in production
+infisical_core['ENCRYPTION_KEY'] = '6c1fe4e407b8911c104518103505b218'
+infisical_core['AUTH_SECRET'] = '5lrMXKKWCVocS/uerPsl7V+TX/aaUaI7iDkgl3tSmLE='
+
+# Database connection strings
+infisical_core['DB_CONNECTION_URI'] = 'postgres://<username>:<password>@<host>:5432/<database>'
+infisical_core['REDIS_URL'] = 'redis://<host>:6379'
+```
+
+For a full list of supported configuration variables, refer to the [configuration variables documentation](/self-hosting/configuration/envars).
+
+## All `infisical-ctl` Commands
+
+The Infisical Linux package includes the `infisical-ctl` command-line tool, which allows you to manage your deployment. 
+The available commands are listed below.
+
+| Command                      | Description                                                                 |
+|-----------------------------|-----------------------------------------------------------------------------|
+| `infisical-ctl reconfigure` | Applies changes from `infisical.rb` and restarts the Infisical services.   |
+| `infisical-ctl start`       | Starts the Infisical services.                                             |
+| `infisical-ctl stop`        | Stops all running Infisical services.                                      |
+| `infisical-ctl status`      | Displays the current status of the Infisical services.                     |
+| `infisical-ctl tail`        | Streams real-time logs from the Infisical application.                     |

docs/self-hosting/deployment-options/native/linux-package/installation.mdx

@@ -0,0 +1,122 @@
+---
+title: "Installation"
+description: "Learn how to deploy Infisical using the Linux package"
+---
+
+Infisical can be deployed on Linux virtual machines without the need for containers using our standalone Linux packages. 
+These packages are available in both .deb (for Debian-based systems) and .rpm (for RHEL-based systems) formats.
+The installation includes the Infisical service, along with a CLI tool (infisical-ctl) to help you manage configurations, startup, and application logging. 
+This approach is ideal for environments where containerization isn't desired, while still providing a lightweight deployment option.
+
+## Prerequisites
+
+This installation method only provides the Infisical application. You are responsible for configuring both PostgreSQL and Redis, either by using managed services (e.g., AWS RDS, Azure Database, GCP Cloud SQL/Memorystore) or by deploying them manually in your on-prem environment. 
+Please ensure you have the following before beginning installation of Infisical:
+
+- A Linux server running a Debian/Ubuntu or RHEL-based distribution
+- A running PostgreSQL database instance (version 14 and up)
+- A running Redis database instance (versions 6.x or 7.x)
+
+## Installation Steps
+
+<Steps>
+
+  <Step title="Install the Infisical Package">
+  Select your Linux distribution to get started. Only AMD64-based systems are supported at this time, ARM support is coming soon.
+
+  <Tabs>
+
+  <Tab title="Debian/Ubuntu">
+  Add the Infisical repository:
+  ```bash
+  curl -1sLf 'https://dl.cloudsmith.io/public/infisical/infisical-core/setup.deb.sh' | sudo -E bash
+  ```
+
+  Install Infisical:
+  ```bash
+  sudo apt-get update && sudo apt-get install -y infisical-core
+  ```
+
+  > **Note**: For production use, we recommend locking to a specific version to ensure consistency. [View available versions](https://cloudsmith.io/~infisical/repos/infisical-core/packages/).
+  </Tab>
+
+  <Tab title="RedHat/CentOS/Amazon Linux">
+  Add the Infisical repository:
+  ```bash
+  curl -1sLf 'https://dl.cloudsmith.io/public/infisical/infisical-core/setup.rpm.sh' | sudo -E bash
+  ```
+
+  Install Infisical:
+  ```bash
+  sudo yum install infisical-core
+  ```
+
+  > **Note**: For production use, we recommend locking to a specific version to ensure consistency. [View available versions](https://cloudsmith.io/~infisical/repos/infisical-core/packages/).
+  </Tab>
+
+  </Tabs>
+
+  Verify the installation:
+  ```bash
+  infisical-ctl help
+  ```
+  </Step>
+
+  <Step title="Create the Configuration File">
+  Create an `infisical.rb` file at `/etc/infisical`. This file contains your database connection strings and other runtime settings.
+
+  ```ruby
+  # Important: Replace with secure values in production
+  infisical_core['ENCRYPTION_KEY'] = '6c1fe4e407b8911c104518103505b218'
+  infisical_core['AUTH_SECRET'] = '5lrMXKKWCVocS/uerPsl7V+TX/aaUaI7iDkgl3tSmLE='
+
+  # Example database connection strings
+  infisical_core['DB_CONNECTION_URI'] = 'postgres://<db-username>:<db-password>@<db-host>:<db-port>/<db-name>'
+  infisical_core['REDIS_URL'] = 'redis://<redis-host>:<redis-port>'
+  ```
+
+  See the full list of options in our [configuration documentation](/self-hosting/configuration/envars).
+  </Step>
+
+  <Step title="Start Infisical">
+  1. Start the Infisical service:
+    ```bash
+    infisical-ctl reconfigure
+    ```
+    The server runs on port `8080` by default (customizable in `infisical.rb`).
+
+  2. Check the service status:
+      ```bash
+      infisical-ctl status
+      ```
+
+    View the service logs in real-time:
+      ```bash
+      infisical-ctl tail
+      ```
+  </Step>
+
+</Steps>
+
+## Platform Support
+
+### Microsoft Windows
+Infisical is built for Linux-based systems. It is not supported on Microsoft Windows, and we do not plan to support it in the near future. For Windows users, consider running Infisical in a virtual machine or WSL2 environment.
+
+### Unsupported Linux Distributions and Unix-like Systems
+Infisical is not tested or officially supported on the following:
+
+- Arch Linux  
+- Fedora  
+- FreeBSD  
+- Gentoo  
+- macOS  
+
+We recommend sticking to officially supported distributions for the best experience.
+
+## Linux vs Containerized Deployments
+
+Infisical is a stateless application, which means it can be easily scaled and redeployed without maintaining internal state between instances.
+
+If your use case requires rolling updates, self-healing, or auto-scaling, we recommend deploying Infisical in a containerized environment such as Kubernetes/OpenShift, or using managed container orchestration services like AWS ECS or Google Cloud Run. 
+These platforms offer built-in capabilities for high availability and help simplify operational overhead for your deployment.

docs/self-hosting/overview.mdx

@@ -33,21 +33,10 @@ Choose from a number of deployment options listed below to get started.
   Use our Helm chart to Install Infisical on your Kubernetes cluster.
   </Card>
 </CardGroup>
-{/* <CardGroup cols={2}>
+<Card
-  <Card
+    title="Linux package"
-    title="Native Deployment"
     color="#000000"
-    icon="box"
+    href="deployment-options/native/linux-package/installation"
-    href="deployment-options/native/standalone-binary"
   >
-    Install Infisical on your Debian-based system without containers using our standalone binary.
+    Install Infisical on your system without containers using our Linux package.
-  </Card>
+</Card>
-  <Card
-    title="Native Deployment, High Availability"
-    color="#000000"
-    icon="boxes-stacked"
-    href="deployment-options/native/high-availability"
-  >
-    Install Infisical on your Debian-based instances without containers using our standalone binary with high availability out of the box.
-  </Card>
-</CardGroup> */}