How to Install Surfer on Fedora CoreOS

Surfer is a simple and efficient open-source reverse proxy designed for developers who want to securely expose a local web server to the internet. In this tutorial, we will show you how to install and configure Surfer on the latest version of Fedora CoreOS.

Prerequisites

  • A VPS or a physical computer running Fedora CoreOS.
  • A terminal emulator with SSH capability.
  • Basic knowledge of the Linux command line interface.
  • A cloudron account with active subscription

Step 1. Install the Cloudron CLI

The first step is to install the Cloudron CLI tool. You can do this by following the instructions on the official Cloudron documentation here: https://cloudron.io/documentation/cli/

Step 2. Create a Surfer app on Cloudron

After installing the CLI tool, open your terminal and log in to your Cloudron account by running the following command:

cloudron login

Provide your Cloudron username and password to authenticate.

Once you are logged in, create a new Surfer app on your Cloudron account by running the following command:

cloudron install --appstore-id surfer

This will create a new Surfer app instance on your Cloudron account.

Step 3. Install Surfer on Fedora CoreOS

Now that you have created a new Surfer app on Cloudron, the next step is to install Surfer on your Fedora CoreOS machine.

To do this, open a terminal and SSH into your Fedora CoreOS machine. Once you are connected, run the following command to download and install Surfer:

sudo podman run -it --rm quay.io/cloudron/surfer:1.2.0 check

This command will download and install the latest version of Surfer on your Fedora CoreOS machine.

Step 4. Configure Surfer

Now that Surfer is installed on your Fedora CoreOS machine, the next step is to configure it to work with your Cloudron Surfer app.

To do this, you will need to retrieve your Cloudron Surfer app's configuration data by running the following command:

cloudron <APP-ID> info

Replace <APP-ID> with the ID of your Cloudron Surfer app instance.

This command will retrieve and display your Cloudron Surfer app's configuration data, including the proxy URL and authentication details.

Copy the configuration data and use it to create a Surfer config file on your Fedora CoreOS machine by running the following command:

sudo tee /etc/surfer.conf <<EOF
<Configuration Data>
EOF

Replace <Configuration Data> with the configuration data you copied earlier.

Save the file and exit.

Step 5. Start Surfer

The final step is to start Surfer by running the following command:

sudo podman run -d --name=surfer -p 80:80 -v /etc/surfer.conf:/etc/surfer/surfer.conf quay.io/cloudron/surfer:1.2.0

This command will start Surfer and map its port 80 to your Fedora CoreOS machine's port 80. Surfer will also use the configuration file you created in the previous step.

Congratulations, you have successfully installed and configured Surfer on your Fedora CoreOS machine. You can now securely expose your local web server to the internet.