Skip to content

Infisical is the open-source platform for securing secrets, certificates, access, and AI Agents.

5.4 KB
Raw Blame
---
title: "Install Infisical with a Linux package"
sidebarTitle: "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're 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, 7.x, or 8.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">

    <Warning>
      As of October 10, 2025, all future releases for Debian/Ubuntu will be distributed via the official Infisical repository at https://artifacts-infisical-core.infisical.com.
      No new releases will be published for Debian/Ubuntu on Cloudsmith going forward.
    </Warning>

      Add the Infisical repository:
      ```bash
      curl -1sLf 'https://artifacts-infisical-core.infisical.com/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://github.com/Infisical/infisical/releases). All versions from `infisical-core-0.150.0~nightly~20251005` and above are supported.

  </Tab>
    <Tab title="RedHat/CentOS/Amazon Linux">

    <Warning>
      As of October 10, 2025, all future releases for Red Hat/CentOS/Amazon Linux will be distributed via the official Infisical repository at https://artifacts-infisical-core.infisical.com.
      No new releases will be published for Red Hat/CentOS/Amazon Linux on Cloudsmith going forward.
    </Warning>

      Add the Infisical repository:
      ```bash
      curl -1sLf 'https://artifacts-infisical-core.infisical.com/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://github.com/Infisical/infisical/releases). All versions from `infisical-core-0.150.0~nightly~20251005` and above are supported.
      
    </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 isn't supported on Microsoft Windows, and we don't 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 isn't 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.