diff --git a/ci/vale/dictionary.txt b/ci/vale/dictionary.txt index 5527a912c55..10ee9a02a4b 100644 --- a/ci/vale/dictionary.txt +++ b/ci/vale/dictionary.txt @@ -338,6 +338,7 @@ clickboard clickjacking client1 client2 +clientless CLIs clojure cloudant @@ -429,6 +430,7 @@ createdt createfromstackscript crewless cri +Cribl CRM CRMs cron @@ -2344,6 +2346,7 @@ shotcut shoutcast shutil sidekiq +SIEMs sievers signup Simula diff --git a/docs/guides/quick-answers/linux/how-to-install-configure-and-run-fish/index.md b/docs/guides/quick-answers/linux/how-to-install-configure-and-run-fish/index.md index 324afec7b8c..9cfbd1732eb 100644 --- a/docs/guides/quick-answers/linux/how-to-install-configure-and-run-fish/index.md +++ b/docs/guides/quick-answers/linux/how-to-install-configure-and-run-fish/index.md @@ -14,6 +14,8 @@ external_resources: - '[Fish Cookbook](https://github.com/jbucaran/fish-shell-cookbook#how-to-find-my-current-location-in-fish)' tags: ["linux"] aliases: ['/quick-answers/linux/how-to-install-configure-and-run-fish/'] +deprecated: true + --- ![How to Install, Configure, and Run the Fish Shell](fish_banner.jpg) @@ -38,7 +40,7 @@ The configuration file for Fish is located at: `~/.config/fish/config.fish`. You ![Customized Fish Shell Configuration File](fish_config.png) -## Regarding Fish +## Use Fish Fish is similar to other shells: you type commands followed by arguments. @@ -57,13 +59,8 @@ However, in Fish, you chain commands with `;`, instead of `&&`: If you can't function without `!!` and `&&`, check [this](https://github.com/fish-shell/fish-shell/wiki/Bash-Refugees) repo out for a solution. - -## Use Fish - -Fish boasts a full-featured scripting language. You can use scripts written in Fish to do anything you would do with a scripting language, and even some cooler [things](https://github.com/onodera-punpun/neet), like managing your anime/drama series. - - ### Functions + Fish does not support aliasing. Instead Fish uses `functions`. Typing `functions` into Fish will output a list of functions that exist by default: diff --git a/docs/marketplace-docs/guides/cribl/index.md b/docs/marketplace-docs/guides/cribl/index.md new file mode 100644 index 00000000000..8db105c19fe --- /dev/null +++ b/docs/marketplace-docs/guides/cribl/index.md @@ -0,0 +1,72 @@ +--- +title: "Deploy Cribl Stream through the Linode Marketplace" +description: "Deploy Cribl Stream for data routing, shaping, and observability pipeline management" +published: 2025-10-03 +keywords: ['cribl', 'stream', 'observability', 'log routing', 'data pipeline'] +tags: ["ubuntu", "marketplace", "observability", "developer", "linode platform", "cloud manager"] +external_resources: +- '[Cribl](https://cribl.io/)' +- '[Cribl Stream official documentation](https://docs.cribl.io/stream/)' +- '[Getting Started with Cribl Stream](https://docs.cribl.io/stream/getting-started/)' +aliases: ['/products/tools/marketplace/guides/cribl-stream/'] +authors: ["Akamai"] +contributors: ["Akamai"] +license: '[CC BY-ND 4.0](https://creativecommons.org/licenses/by-nd/4.0)' +--- + +Cribl Stream is a vendor-agnostic observability pipeline that gives you full control over your data—allowing you to route, shape, enrich, and reduce event data from any source to any destination. It enables organizations to optimize costs and improve observability by filtering and transforming data before it reaches downstream systems like SIEMs, observability platforms, or data lakes. With its intuitive UI and powerful processing engine, Cribl Stream makes it easier to manage high-volume data ingestion without sacrificing visibility. + +This guide includes steps for deploying the Cribl Stream Marketplace App on a Linode instance. + +## Deploying a Marketplace App + +{{% content "deploy-marketplace-apps-shortguide" %}} + +{{% content "marketplace-verify-standard-shortguide" %}} + +{{< note >}} +**Estimated deployment time:** Once a Compute Instance finishes provisioning, the Cribl Stream installation takes approximately 3-5 minutes. +{{< /note >}} + +## Configuration Options + +- **Supported distributions:** Ubuntu 24.04 LTS +- **Recommended minimum plan:** All plan types and sizes can be used, though larger instances are recommended for high-volume data processing. + +### Cribl Stream Options + +- **Limited sudo user** *(required)*: Enter your preferred username for the limited user. Don't use capital letters, spaces, or special characters. +- **Disable root access over SSH** *(required)*: Select whether you want to block the root user from logging in over SSH. You can still switch to the root user once logged in, and you can also log in as root through Lish. + +{{% content "marketplace-special-character-limitations-shortguide" %}} + +### Obtain the Credentials + +Once the app is deployed, you need to obtain the credentials from the server. To obtain the credentials: + +1. Log in to your new Compute Instance using one of the methods below: + + - **Lish Console**: Log in to Cloud Manager, click the **Linodes** link in the left menu, and select the Compute Instance you just deployed. Click **Launch LISH Console**. Log in as the `root` user. To learn more, see [Using the Lish Console](/docs/products/compute/compute-instances/guides/lish/). + - **SSH**: Log in to your Compute Instance over SSH using the `root` user. To learn how, see [Connecting to a Remote Server Over SSH](/docs/guides/connect-to-server-over-ssh/). + +2. Run the following command to access the contents of the credentials file: + + ```command + cat /home/$USERNAME/.credentials + ``` + +This returns the admin password and other details that were automatically generated when the instance was deployed. Save them securely. Once saved, you can safely delete the file. + +## Getting Started After Deployment + +Once you've obtained the credentials, you can access your Cribl instance and open a browser and navigate to your Linode domain entered during deployment or the rDNS domain `https://203-0-113-0.ip.linodeusercontent.com`. + +1. In a browser, paste your instance's rDNS domain. Replace `{{< placeholder "https://203-0-113-0.ip.linodeusercontent.com" >}}` with your [Linode's actual rDNS domain](/docs/products/compute/compute-instances/guides/manage-ip-addresses/#viewing-ip-addresses). + +2. Log in with the admin username (`admin`) and the password in the credentials file. + +3. Follow the [Getting Started with Cribl Stream guide](https://docs.cribl.io/stream/getting-started/) to configure data sources, routes, and destinations. + +If you don’t have a Cribl account yet, you can create one for free at [https://cribl.io](https://cribl.io) to access additional resources and support. + +{{% content "marketplace-update-note-shortguide" %}} diff --git a/docs/marketplace-docs/guides/guacamole/guacamole-login-screen.png b/docs/marketplace-docs/guides/guacamole/guacamole-login-screen.png deleted file mode 100644 index fc3bb9f4c1f..00000000000 Binary files a/docs/marketplace-docs/guides/guacamole/guacamole-login-screen.png and /dev/null differ diff --git a/docs/marketplace-docs/guides/guacamole/index.md b/docs/marketplace-docs/guides/guacamole/index.md index 96776109542..d60d6bb8878 100644 --- a/docs/marketplace-docs/guides/guacamole/index.md +++ b/docs/marketplace-docs/guides/guacamole/index.md @@ -1,10 +1,10 @@ --- title: "Deploy Apache Guacamole through the Linode Marketplace" -description: "Use the Guacamole Marketplace App to easily install the popular open source remote desktop and access your Linode from any device." +description: "Deploy Apache Guacamole, a clientless remote desktop gateway that supports VNC, RDP, and SSH protocols through a web browser, on an Akamai Compute Instance." published: 2020-12-11 -modified: 2023-03-14 +modified: 2025-10-03 keywords: ['guacamole', 'marketplace', 'remote desktop'] -tags: ["cloud-manager","linode platform","cms","marketplace"] +tags: ["cloud-manager","linode platform","marketplace"] aliases: ['/products/tools/marketplace/guides/guacamole/','/platform/marketplace/guacamole/','/guides/deploy-guacamole-with-marketplace-apps/','/guides/guacamole-marketplace-app/'] external_resources: - '[Guacamole Documentation](https://guacamole.apache.org/doc/gug/)' @@ -15,7 +15,7 @@ marketplace_app_id: 688914 marketplace_app_name: "Apache Guacamole" --- -[Apache Guacamole](https://guacamole.apache.org/) is an open source HTML5-based web application used as a remote desktop gateway. With the Guacamole Marketplace App, you can access your Compute Instance with a graphical VNC session using the [Xfce](https://www.xfce.org/) desktop environment from any device. This Marketplace App installs and configures Guacamole on a Compute Instance, complete with an SSL certificate generated by [Certbot](https://certbot.eff.org/) for your domain. +[Apache Guacamole](https://guacamole.apache.org/) is a clientless remote desktop gateway that provides access to desktop environments using remote desktop protocols (VNC, RDP, SSH) through a standard web browser. Unlike traditional remote access solutions, Guacamole requires no plugins or client software installation, making it ideal for accessing remote systems from any device. This deployment uses Docker containers with PostgreSQL database backend for scalable user and connection management, NGINX reverse proxy for security, and automated SSL certificate management. ## Deploying a Marketplace App @@ -24,57 +24,37 @@ marketplace_app_name: "Apache Guacamole" {{% content "marketplace-verify-standard-shortguide" %}} {{< note >}} -**Estimated deployment time:** Apache Guacamole should be fully installed within 5-20 minutes after the Compute Instance has finished provisioning. +**Estimated deployment time:** Apache Guacamole should be fully installed within 5-10 minutes after the Compute Instance has finished provisioning. {{< /note >}} ## Configuration Options -- **Supported distributions:** Ubuntu 22.04 LTS -- **Recommended plan:** We recommend a 4GB Dedicated CPU or Shared CPU Compute Instance. +- **Supported distributions:** Ubuntu 24.04 LTS +- **Recommended plan:** All plan types and sizes can be used. For production workloads managing multiple remote connections, consider at least 4GB Dedicated CPU or Shared CPU Compute or higher for optimal performance. ### Guacamole Options -- **The limited sudo/VNC user to be created for the Linode** *(required)*: The VNC username created for this Compute Instance with sudo permissions. This is used for your VNC session. -- **The password for the limited sudo/VNC user** *(required)*: Password for your sudo/VNC user. This is used for your VNC session. -- **The username to be used with Guacamole** *(required)*: Your Guacamole Username. This is used to log in to Guacamole. -- **The password to be used with Guacamole** *(required)*: Your Guacamole Password. This is used to log in to Guacamole. +- **Email address** *(required)*: Enter a valid email address to use for generating the SSL certificates. -#### Limited User SSH Options (Optional) - -- **SSH public key for the limited user:** If you wish to login as the limited user through public key authentication (without entering a password), enter your public key here. See [Creating an SSH Key Pair and Configuring Public Key Authentication on a Server](/docs/guides/use-public-key-authentication-with-ssh/) for instructions on generating a key pair. -- **Disable root access over SSH:** To block the root user from logging in over SSH, select *Yes* (recommended). You can still switch to the root user once logged in and you can also log in as root through [Lish](/docs/products/compute/compute-instances/guides/lish/). +{{% content "marketplace-required-limited-user-fields-shortguide" %}} {{% content "marketplace-custom-domain-fields-shortguide" %}} -- **Admin Email:** The email address to register with [Certbot](https://certbot.eff.org/) when generating an SSL certificate for your absolute domain. This field is required along with your `API Token` and `Domain` for HTTPS access to your Guacamole remote desktop. {{% content "marketplace-special-character-limitations-shortguide" %}} ## Getting Started after Deployment -### Access your Guacamole App - -After Guacamole has finished installing, the Compute Instance will reboot. Once the instance fully boots back up, you can access the dashboard by following the instructions below. - -1. Open your web browser and navigate to the custom domain you entered during deployment or your Compute Instance's rDNS domain (such as `192-0-2-1.ip.linodeusercontent.com`). The site uses the secure HTTPS protocol. - -1. In the Apache Guacamole login window that appears, enter the username and password you specified for Guacamole during deployment. - - ![Screenshot of the Guacamole login page.](guacamole-login-screen.png) - - {{< note >}} - The Guacamole login page may take several minutes to become available while the Application completes the creation process. - {{< /note >}} - -1. Once you have logged in, the Xfce graphical desktop environment for your Compute Instance will appear. This provides you with full access to your internal system through the VNC user you created. - - ![Screenshot of the Xfce desktop](xfce-desktop.png) +### Accessing the Guacamole Web Interface -1. Additional tasks can be performed remotely through your web browser. For example, you can install the [Firefox](https://www.mozilla.org/firefox) web browser for use with your Guacamole remote desktop by entering the following command in its Terminal Emulator: +1. Open your web browser and navigate to `https://[domain]`, where *[domain]* is the custom domain you entered during deployment or your Compute Instance's rDNS domain (such as `192-0-2-1.ip.linodeusercontent.com`). To learn more about viewing IP addresses and rDNS, see the [Managing IP Addresses](/docs/products/compute/compute-instances/guides/manage-ip-addresses/). - ```command - sudo apt install firefox-esr - ``` +2. You should see the Apache Guacamole login page. Log in using the default credentials: + - **Username:** `guacadmin` + - **Password:** The password is automatically generated and stored in the credentials file. To retrieve it, log in to your Compute Instance via SSH or Lish and run the below `cat` command: + ```command + cat /home/$USER/.credentials + ``` - When prompted, enter the password you chose for the limited sudo/VNC user. You can now browse the web on your Guacamole browser from within your local browser. +After logging in, you are brought to the Guacamole Web Interface. This is your central dashboard where you can create connections, and manage user accounts and permissions. {{% content "marketplace-update-note-shortguide" %}} diff --git a/docs/marketplace-docs/guides/guacamole/xfce-desktop.png b/docs/marketplace-docs/guides/guacamole/xfce-desktop.png deleted file mode 100644 index 85b44fee584..00000000000 Binary files a/docs/marketplace-docs/guides/guacamole/xfce-desktop.png and /dev/null differ