diff --git a/docs/marketplace-docs/guides/apache-airflow/index.md b/docs/marketplace-docs/guides/apache-airflow/index.md index 051e46184c8..b492b5d2058 100644 --- a/docs/marketplace-docs/guides/apache-airflow/index.md +++ b/docs/marketplace-docs/guides/apache-airflow/index.md @@ -32,7 +32,7 @@ To learn more about Airflow and determine if it's the right tool for you, read t ## Configuration Options -- **Supported distributions:** Ubuntu 20.04 LTS +- **Supported distributions:** Ubuntu 24.04 LTS - **Recommended plan:** All plan types and sizes can be used. ### Apache Airflow Options @@ -45,45 +45,41 @@ To learn more about Airflow and determine if it's the right tool for you, read t {{% content "marketplace-special-character-limitations-shortguide" %}} -## Getting Started after Deployment +### Obtain the Credentials -1. Log into your new Compute Instance through [LISH](/docs/products/compute/compute-instances/guides/lish/) or [SSH](/docs/products/compute/compute-instances/guides/set-up-and-secure/#connect-to-the-instance) using the root user and the password you entered when creating the instance. +Once the app is deployed, you need to obtain the credentials from the server. To obtain the credentials: -1. If you log in on the same day you deployed the app, a message is displayed with a link to your Apache Airflow GUI and the username and password to use. +1. Log in to your new Compute Instance using one of the methods below: - ```output - The installation of Apache Airflow is now complete, and the application is running in standalone mode. - # - You can log into the Airflow GUI at 192-0-2-170.ip.linodeusercontent.com - With the credentials: - Username: admin - Password: pNbgWNDhYcRNvgRq - # - Standalone mode is not recommended for production. - ``` + - **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/). - If you don't see this message, you can output it using the command below: +2. Run the following command to access the contents of the credentials file: ```command - cat /etc/motd + cat /home/$USERNAME/.credentials ``` -1. Open your web browser and navigate to the Airflow URL provided in the last step. This should be the custom domain you entered during deployment or your Compute Instance's rDNS domain (such as `192-0-2-1.ip.linodeusercontent.com`). See the [Managing IP Addresses](/docs/products/compute/compute-instances/guides/manage-ip-addresses/) guide for information on viewing the rDNS. +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 Apache Airflow 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. Within the Airflow login prompt that appears, enter the credentials provided in a previous step and sign in. +Within the Airflow login prompt that appears, enter the credentials provided in the credentials file and sign in. ![Screenshot of the Airflow login prompt](airflow-login.png) -1. Once you are signed in, the Airflow dashboard appears. From here, you can view the DAGs (Directed Acyclic Graphs) and access all other areas of the dashboard. +Once you are signed in, the Airflow dashboard appears. From here, you can view the DAGs (Directed Acyclic Graphs) and access all other areas of the dashboard. ![Screenshot of Apache Airflow GUI](airflow-gui.png) -1. You can now start using Apache Airflow. If you are unfamiliar with it, consider reading through the official documentation or Linode's own guides: +You can now start using Apache Airflow. If you are unfamiliar with it, consider reading through the official documentation or Linode's own guides: - [Airflow > Tutorials](https://airflow.apache.org/docs/apache-airflow/stable/tutorial/index.html) - [Airflow > How-to Guides](https://airflow.apache.org/docs/apache-airflow/stable/howto/index.html) - [Create Connections and Variables in Apache Airflow](/docs/guides/apache-airflow-tutorial-creating-connections-and-variables/) {{< note type="warning">}} -The Akamai Quick Deploy App app deploys Apache Airflow in standalone mode, suitable for development, testing, and initial configurations. Standalone mode is not recommended for [production deployments](https://airflow.apache.org/docs/apache-airflow/stable/production-deployment.html). +This Akamai Quick Deploy App deploys Apache Airflow in standalone mode, suitable for development, testing, and initial configurations. Standalone mode is not recommended for [production deployments](https://airflow.apache.org/docs/apache-airflow/stable/production-deployment.html). {{< /note >}} \ No newline at end of file diff --git a/docs/marketplace-docs/guides/mastodon/index.md b/docs/marketplace-docs/guides/mastodon/index.md index b3dd6346535..2bc55ff1059 100644 --- a/docs/marketplace-docs/guides/mastodon/index.md +++ b/docs/marketplace-docs/guides/mastodon/index.md @@ -24,11 +24,6 @@ Mastodon servers range in size from small private instances to massive public in {{% content "email-warning-shortguide" %}} -{{< note >}} -The Mastodon Quick Deploy App *requires* a custom domain. After deploying Mastodon, see the instructions within the [Configure Your Domain's Name Servers](#configure-your-domains-name-servers) section. Depending on a variety of factors, new and updated DNS records can take up to 48 hours to fully propagate, though it usually happens much sooner. The deployment fails if the DNS has still not been propagated. - -{{< /note >}} - ## Deploying a Quick Deploy App {{% content "deploy-marketplace-apps-shortguide" %}} @@ -41,54 +36,42 @@ The Mastodon Quick Deploy App *requires* a custom domain. After deploying Mastod ## Configuration Options -- **Supported distributions:** Ubuntu 22.04 LTS +- **Supported distributions:** Ubuntu 24.04 LTS - **Recommended minimum plan:** 2GB Shared CPU Compute Instance or higher ### Mastodon Options {{% content "marketplace-required-limited-user-fields-shortguide" %}} -- **Domain** (*required*): The domain name you wish to use for the mastodon server, such as *example.com*. -- **Linode API Token** (*required*): A personal access token for your account. The Linode API is used to create DNS records for your custom domain through the [DNS Manager](/docs/products/networking/dns-manager/). See [Get an API Access Token](/docs/products/platform/accounts/guides/manage-api-tokens/). +{{% content "marketplace-custom-domain-fields-shortguide" %}} + +{{% content "marketplace-special-character-limitations-shortguide" %}} + - **Email for the Let's Encrypt certificate** (*required*): The email you wish to use when creating your TLS/SSL certificate through Let's Encrypt. This email address receives notifications when the certificate needs to be renewed. - **Username for the Mastodon Owner** (*required*): The username for the Owner user that will be created for the Mastodon server. - **Email Address for the Mastodon Owner** (*required*): The contact email for the Mastodon server's owner. - **Single-user mode** (*required*): Enabling Single User Mode prevents other users from joining the Mastodon Server. -## Getting Started after Deployment - -### Configure Your Domain's Name Servers - -To use Mastodon with the custom domain you specified during deployment, you must configure the domain to use Linode's name servers. This is typically accomplished directly through your registrar. See [Use Linode’s Name Servers with Your Domain](/docs/products/networking/dns-manager/guides/authoritative-name-servers/). +### Obtain the Credentials -### View the Mastodon Site +Once the app is deployed, you need to obtain the credentials from the server. To obtain the credentials: -Open a web browser and navigate to the custom domain you entered when deploying Mastodon. This opens the Explore page in Mastodon, which displays public information about your site, public posts, and links to login or create an account. +1. Log in to your new Compute Instance using one of the methods below: -### Access Your Mastodon Account and Settings + - **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/). -1. **Obtain and save passwords** that were generated on your behalf during deployment, including your Mastodon user's password. +2. Run the following command to access the contents of the credentials file: - 1. Log in to your new Compute Instance through [Lish](/docs/products/compute/compute-instances/guides/lish/) or [SSH](/docs/guides/connect-to-server-over-ssh/) using the `root` user and the associated password you entered when creating the instance. + ```command + cat /home/$USERNAME/.credentials + ``` - 1. The passwords have been saved in the /root/.deployment-secrets.txt file. You can view this file in your preferred text editor or through the `cat` command: +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. - ```command - cat /root/.deployment-secrets.txt - ``` - - The file contains your PSQL password and user's (owner's) password. - - ```file {title="/root/.deployment-secrets.txt"} - # BEGIN ANSIBLE MANAGED BLOCK - # PSQL password - password: WiLjKhJSZE01TW3AoqViN3Kglu2bidWt - # Owner password - password: 3c4a675311ee52c0c1d7173d5169a10d - # END ANSIBLE MANAGED BLOCK - ``` +## Getting Started after Deployment -1. **Log in to Mastodon.** Within a web browser, navigate to `https://[domain.tld]/auth/sign_in`, replacing *[domain.tld]* with the custom domain you entered when deploying Mastodon. This opens the login page. Enter the owner's email address you created and the password that you obtained in the previous step. Once logged in, your user's home page is opened, which displays your own timeline, the post creation form, and links to navigate around. +1. **Access Mastodon UI**. Open a web browser and navigate to `https://[domain.tld]/auth/sign_in`, replacing *[domain.tld]* with the domain you entered when deploying Mastodon or the rDNS domain `https://203-0-113-0.ip.linodeusercontent.com`. This opens the login page. Enter the owner's email address you created and the password that you obtained in the credentials file. ![Screenshot of the Mastodon user home page](mastodon-user-home.png)