Remote Falcon

The configure-rf script will help configure the .env variables that are required to run Remote Falcon. It will also kick off other helper scripts to update container tags and perform some health checks after all containers are up and running.

Download and run configure-rf script

Download the script to your desired directory. Your current directory can be verified with pwd command.

Run the command below. The command will download the configure-rf script, make it executable, and run it automatically.

curl -O https://raw.githubusercontent.com/Ne0n09/cloudflared-remotefalcon/main/configure-rf.sh; \
chmod +x configure-rf.sh; \
./configure-rf.sh

Note

The configure-rf script will automatically download additional helper scripts and create 'remotefalcon' and 'remotefalcon-backups' directories.

Make sure you have the following information available to copy and paste as the configuration script will ask for these:

Cloudflare Tunnel token
Cloudflare origin server certificate
Cloudflare origin server private key

If everything went to plan with the configuration you should see your containers all up similar to below:

CONTAINER ID   IMAGE                                      COMMAND                  CREATED          STATUS          PORTS                                                             NAMES
9a6a8428cace   control-panel:e6c110c                      "/bin/sh -c 'exec ja…"   21 seconds ago   Up 20 seconds   8080/tcp                                                          control-panel
9279b7669e75   minio/minio:RELEASE.2025-05-24T17-08-30Z   "/usr/bin/docker-ent…"   38 seconds ago   Up 37 seconds   0.0.0.0:9000-9001->9000-9001/tcp, [::]:9000-9001->9000-9001/tcp   remote-falcon-images.minio
5549dad80125   ui:cb19864                                 "docker-entrypoint.s…"   49 seconds ago   Up 47 seconds   3000/tcp                                                          ui
73cfd4d5f7da   external-api:f7e09fe                       "/bin/sh -c 'exec ja…"   50 seconds ago   Up 48 seconds   8080/tcp                                                          external-api
f68aacb72ec3   viewer:b7cfb2d                             "/app/application -D…"   50 seconds ago   Up 48 seconds   8080/tcp                                                          viewer
d1b5f2540758   plugins-api:cc1593a                        "/bin/sh -c 'exec ja…"   50 seconds ago   Up 48 seconds   8080/tcp, 0.0.0.0:8083->8083/tcp, [::]:8083->8083/tcp             plugins-api
dd12ab4fa10c   mongo:8.0.9                                "docker-entrypoint.s…"   51 seconds ago   Up 48 seconds   27017/tcp                                                         mongo
aa85a908e37a   nginx:latest                               "/docker-entrypoint.…"   51 seconds ago   Up 47 seconds   80/tcp                                                            nginx
db51c56fbbfd   cloudflare/cloudflared:latest              "cloudflared --no-au…"   51 seconds ago   Up 48 seconds                                                                     cloudflared

If all looks OK you can then move on to post install or if you see errors check the troubleshooting section.

The configuration script can be re-run with ./configure-rf.sh to help make any changes if needed.

You can also directly run the health_check, update_rf_containers, or update_containers helper scripts directly as well.