You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
@@ -38,7 +40,7 @@ The configuration file for Fish is located at: `~/.config/fish/config.fish`. You
38
40
39
41
40
42
41
-
## Regarding Fish
43
+
## Use Fish
42
44
43
45
Fish is similar to other shells: you type commands followed by arguments.
44
46
@@ -57,13 +59,8 @@ However, in Fish, you chain commands with `;`, instead of `&&`:
57
59
58
60
If you can't function without `!!` and `&&`, check [this](https://github.com/fish-shell/fish-shell/wiki/Bash-Refugees) repo out for a solution.
59
61
60
-
61
-
## Use Fish
62
-
63
-
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.
64
-
65
-
66
62
### Functions
63
+
67
64
Fish does not support aliasing. Instead Fish uses `functions`. Typing `functions` into Fish will output a list of functions that exist by default:
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.
18
+
19
+
This guide includes steps for deploying the Cribl Stream Marketplace App on a Linode instance.
**Estimated deployment time:** Once a Compute Instance finishes provisioning, the Cribl Stream installation takes approximately 3-5 minutes.
29
+
{{< /note >}}
30
+
31
+
## Configuration Options
32
+
33
+
-**Supported distributions:** Ubuntu 24.04 LTS
34
+
-**Recommended minimum plan:** All plan types and sizes can be used, though larger instances are recommended for high-volume data processing.
35
+
36
+
### Cribl Stream Options
37
+
38
+
-**Limited sudo user***(required)*: Enter your preferred username for the limited user. Don't use capital letters, spaces, or special characters.
39
+
-**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.
Once the app is deployed, you need to obtain the credentials from the server. To obtain the credentials:
46
+
47
+
1. Log in to your new Compute Instance using one of the methods below:
48
+
49
+
-**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/).
50
+
-**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/).
51
+
52
+
2. Run the following command to access the contents of the credentials file:
53
+
54
+
```command
55
+
cat /home/$USERNAME/.credentials
56
+
```
57
+
58
+
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.
59
+
60
+
## Getting Started After Deployment
61
+
62
+
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`.
63
+
64
+
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).
65
+
66
+
2. Log in with the admin username (`admin`) and the password in the credentials file.
67
+
68
+
3. Follow the [Getting Started with Cribl Stream guide](https://docs.cribl.io/stream/getting-started/) to configure data sources, routes, and destinations.
69
+
70
+
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.
title: "Deploy Apache Guacamole through the Linode Marketplace"
3
-
description: "Use the Guacamole Marketplace App to easily install the popular open source remote desktop and access your Linode from any device."
3
+
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."
[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.
18
+
[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.
**Estimated deployment time:** Apache Guacamole should be fully installed within 5-20 minutes after the Compute Instance has finished provisioning.
27
+
**Estimated deployment time:** Apache Guacamole should be fully installed within 5-10 minutes after the Compute Instance has finished provisioning.
28
28
{{< /note >}}
29
29
30
30
## Configuration Options
31
31
32
-
-**Supported distributions:** Ubuntu 22.04 LTS
33
-
-**Recommended plan:** We recommend a 4GB Dedicated CPU or Shared CPU Compute Instance.
32
+
-**Supported distributions:** Ubuntu 24.04 LTS
33
+
-**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.
34
34
35
35
### Guacamole Options
36
36
37
-
-**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.
38
-
-**The password for the limited sudo/VNC user***(required)*: Password for your sudo/VNC user. This is used for your VNC session.
39
-
-**The username to be used with Guacamole***(required)*: Your Guacamole Username. This is used to log in to Guacamole.
40
-
-**The password to be used with Guacamole***(required)*: Your Guacamole Password. This is used to log in to Guacamole.
37
+
-**Email address***(required)*: Enter a valid email address to use for generating the SSL certificates.
41
38
42
-
#### Limited User SSH Options (Optional)
43
-
44
-
-**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.
45
-
-**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/).
-**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.
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.
57
-
58
-
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.
59
-
60
-
1. In the Apache Guacamole login window that appears, enter the username and password you specified for Guacamole during deployment.
61
-
62
-
63
-
64
-
{{< note >}}
65
-
The Guacamole login page may take several minutes to become available while the Application completes the creation process.
66
-
{{< /note >}}
67
-
68
-
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.
69
-
70
-
47
+
### Accessing the Guacamole Web Interface
71
48
72
-
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:
49
+
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/).
73
50
74
-
```command
75
-
sudo apt install firefox-esr
76
-
```
51
+
2. You should see the Apache Guacamole login page. Log in using the default credentials:
52
+
-**Username:**`guacadmin`
53
+
-**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:
54
+
```command
55
+
cat /home/$USER/.credentials
56
+
```
77
57
78
-
When prompted, enter the password you chose forthe limited sudo/VNC user. You can now browse the web on your Guacamole browser from within your local browser.
58
+
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.
0 commit comments