# Self-Hosting **URL:** https://community.openfn.org/c/self-hosting/6.md [Latest](https://community.openfn.org/latest.md) · [Categories](https://community.openfn.org/categories.md) --- ## [About the Self-Hosting category](https://community.openfn.org/t/about-the-self-hosting-category/57)
**Author:** [@taylordowns2000](https://community.openfn.org/u/taylordowns2000)\ **Replies:** 1\ **Last updated:** [August 27, 2024, 10:28pm UTC](https://community.openfn.org/t/about-the-self-hosting-category/57 "2024-08-27T22:28:16Z")
This topic is for OpenFn users to ask and answer questions about their local deployment strategies. Head to Planning | OpenFn/docs for a getting started guide to thinking about deployment. --- ## [Unable to save kafka triggered workflow](https://community.openfn.org/t/unable-to-save-kafka-triggered-workflow/1184)
**Author:** [@mohau](https://community.openfn.org/u/mohau)\ **Replies:** 2\ **Last updated:** [January 30, 2026, 1:46pm UTC](https://community.openfn.org/t/unable-to-save-kafka-triggered-workflow/1184 "2026-01-30T13:46:03Z")
I am running openFn via docker on ubuntu Ubuntu 24.04.3 LTS --- ## [Issue: Cannot use 'in' operator to search for 'common' in undefined](https://community.openfn.org/t/issue-cannot-use-in-operator-to-search-for-common-in-undefined/1117)
**Author:** [@SimonKihara](https://community.openfn.org/u/SimonKihara)\ **Replies:** 7\ **Last updated:** [October 13, 2025, 7:55am UTC](https://community.openfn.org/t/issue-cannot-use-in-operator-to-search-for-common-in-undefined/1117 "2025-10-13T07:55:41Z")
I have managed to self host a lighting instance. Creating a specific workflow, I’m landing into this issue. I have shared the screenshot of the video. The instance is running on top of docker. @midigofrank @joe --- ## [Hosting Ligthning on a subpath](https://community.openfn.org/t/hosting-ligthning-on-a-subpath/1098)
**Author:** [@gnnko](https://community.openfn.org/u/gnnko)\ **Replies:** 3\ **Last updated:** [September 10, 2025, 8:16am UTC](https://community.openfn.org/t/hosting-ligthning-on-a-subpath/1098 "2025-09-10T08:16:58Z")
Hello, I’m currently working on deploying the latest Lightning instance on the subpath /openfn using the docker deployment guide. I have set the URL\_HOST to my-domain.com/openfn and when the web container starts it does… --- ## [Managing Lost Runs](https://community.openfn.org/t/managing-lost-runs/1089)
**Author:** [@midigofrank](https://community.openfn.org/u/midigofrank)\ **Replies:** 0\ **Last updated:** [September 4, 2025, 10:49am UTC](https://community.openfn.org/t/managing-lost-runs/1089 "2025-09-04T10:49:44Z")
A run is marked as lost when the worker claims it but fails to inform lightning that it has completed it. What causes lost runs? As of the day of writing this post, we have narrowed down to the following: DB Connecti… --- ## [Error while creating event/scheduler based workflow](https://community.openfn.org/t/error-while-creating-event-scheduler-based-workflow/1036)
**Author:** [@moukaila](https://community.openfn.org/u/moukaila)\ **Replies:** 3\ **Last updated:** [August 22, 2025, 5:54am UTC](https://community.openfn.org/t/error-while-creating-event-scheduler-based-workflow/1036 "2025-08-22T05:54:43Z")
After installing Lightning from the github repository with docker, we’re having the following issue when trying to create an event based workflow System specification: Ubuntu 24.04 desktop Need help to fix this pls … --- ## [openFN Lightning docker compose local build failed](https://community.openfn.org/t/openfn-lightning-docker-compose-local-build-failed/955)
**Author:** [@sohel](https://community.openfn.org/u/sohel)\ **Replies:** 3\ **Last updated:** [June 5, 2025, 2:27pm UTC](https://community.openfn.org/t/openfn-lightning-docker-compose-local-build-failed/955 "2025-06-05T14:27:54Z")
Dear Altruist, We were trying to set up openFN Lightning on our local server using Docker, We were following the instructions from Run via Docker We were getting a build failure after running the following Docker comma… --- ## [Vanilla docker compose configuration?](https://community.openfn.org/t/vanilla-docker-compose-configuration/472)
**Author:** [@taylordowns2000](https://community.openfn.org/u/taylordowns2000)\ **Replies:** 3\ **Last updated:** [May 19, 2025, 11:37am UTC](https://community.openfn.org/t/vanilla-docker-compose-configuration/472 "2025-05-19T11:37:33Z")
@ibrahimwickama , for a vanilla docker-compose? version: "3.8" services: postgres: deploy: resources: limits: cpus: '${DOCKER\_POSTGRES\_CPUS:-0}' memory: '${DOCKER\_POSTGRES\_MEMORY… --- ## [Frequent Lost Orders on OpenFn v2.10.7](https://community.openfn.org/t/frequent-lost-orders-on-openfn-v2-10-7/951)
**Author:** [@Kenyuri](https://community.openfn.org/u/Kenyuri)\ **Replies:** 1\ **Last updated:** [April 29, 2025, 11:06am UTC](https://community.openfn.org/t/frequent-lost-orders-on-openfn-v2-10-7/951 "2025-04-29T11:06:56Z")
Hi team, We’re currently experiencing frequent lost runs on our OpenFn v2.10.7 instance deployed in OpenShift. From our logs, here are the consistent patterns: DBConnection.ConnectionError due to connection refused … --- ## [Can't see adaptor icons when hosting my own instance](https://community.openfn.org/t/cant-see-adaptor-icons-when-hosting-my-own-instance/946)
**Author:** [@stephencoduor](https://community.openfn.org/u/stephencoduor)\ **Replies:** 6\ **Last updated:** [April 15, 2025, 9:48am UTC](https://community.openfn.org/t/cant-see-adaptor-icons-when-hosting-my-own-instance/946 "2025-04-15T09:48:29Z")
Hello, I am Running Self hosted Instance, Wondering why adaptors Icons are not being rendered, I have tried to reinstall many times, Checked the documentation but there is nothing mentioning rendering Icons Kindly h… --- ## [Unable to verify via email so blocked from using self-hosted local test instance](https://community.openfn.org/t/unable-to-verify-via-email-so-blocked-from-using-self-hosted-local-test-instance/480)
**Author:** [@Cord42](https://community.openfn.org/u/Cord42)\ **Replies:** 3\ **Last updated:** [August 28, 2024, 4:33pm UTC](https://community.openfn.org/t/unable-to-verify-via-email-so-blocked-from-using-self-hosted-local-test-instance/480 "2024-08-28T16:33:45Z")
Self-hosted local instances for testing say they are sending a verification email upon completion of setup but do not seem to do so in all cases. I have not found information about setup to assist this email successfully… --- ## [Lightning installation issue](https://community.openfn.org/t/lightning-installation-issue/859)
**Author:** [@shubham](https://community.openfn.org/u/shubham)\ **Replies:** 4\ **Last updated:** [February 24, 2025, 9:04am UTC](https://community.openfn.org/t/lightning-installation-issue/859 "2025-02-24T09:04:05Z")
Hi everyone, I was attempting to install the OpenFN Lightning application using Docker by following the instructions in the README file. Initially, I encountered an issue where the worker service wouldn’t start due to a… --- ## [Deploying the openFN Lightning project](https://community.openfn.org/t/deploying-the-openfn-lightning-project/739)
**Author:** [@yemane](https://community.openfn.org/u/yemane)\ **Replies:** 3\ **Last updated:** [December 12, 2024, 9:50pm UTC](https://community.openfn.org/t/deploying-the-openfn-lightning-project/739 "2024-12-12T21:50:58Z")
How can I deploy OpenFN Lightning on AWS? Do you have any resources or documentation for this? --- ## [OpenFN Lightning Installation on Ubuntu Server](https://community.openfn.org/t/openfn-lightning-installation-on-ubuntu-server/742)
**Author:** [@Prime](https://community.openfn.org/u/Prime)\ **Replies:** 1\ **Last updated:** [December 9, 2024, 4:41pm UTC](https://community.openfn.org/t/openfn-lightning-installation-on-ubuntu-server/742 "2024-12-09T16:41:38Z")
Hello OpenFN Community, I want to install OpenFN on my ubuntu digital ocean server. I understand it is easier with docker,but can someone help with documentation on how to install and set it up on ubuntu server and the e… --- ## [Not getting an email on http://localhost:4000/dev/mailbox for verification in local deployment](https://community.openfn.org/t/not-getting-an-email-on-http-localhost-4000-dev-mailbox-for-verification-in-local-deployment/490)
**Author:** [@dmmktz](https://community.openfn.org/u/dmmktz)\ **Replies:** 4\ **Last updated:** [November 25, 2024, 9:46am UTC](https://community.openfn.org/t/not-getting-an-email-on-http-localhost-4000-dev-mailbox-for-verification-in-local-deployment/490 "2024-11-25T09:46:11Z")
I’m running into the same problem as described at this post, Unable to verify via email so blocked from using self-hosted local test instance Difference is there is nothing on http://localhost:4000/dev/mailbox to use fo… --- ## [Not getting an email on http://localhost:4000/dev/mailbox for verification in local deployment and i want to use the pre build image](https://community.openfn.org/t/not-getting-an-email-on-http-localhost-4000-dev-mailbox-for-verification-in-local-deployment-and-i-want-to-use-the-pre-build-image/646)
**Author:** [@saurajthapa](https://community.openfn.org/u/saurajthapa)\ **Replies:** 0\ **Last updated:** [November 22, 2024, 6:15am UTC](https://community.openfn.org/t/not-getting-an-email-on-http-localhost-4000-dev-mailbox-for-verification-in-local-deployment-and-i-want-to-use-the-pre-build-image/646 "2024-11-22T06:15:02Z")
I have configured OpenFn using Docker in a production environment, but I’m unable to verify my account via email. I am trying to use Postmark for email relay. --- ## [Is GitHub Sync available for self-hosted instances? Version control is crucial](https://community.openfn.org/t/is-github-sync-available-for-self-hosted-instances-version-control-is-crucial/479)
**Author:** [@Cord42](https://community.openfn.org/u/Cord42)\ **Replies:** 4\ **Last updated:** [August 29, 2024, 3:35am UTC](https://community.openfn.org/t/is-github-sync-available-for-self-hosted-instances-version-control-is-crucial/479 "2024-08-29T03:35:42Z")
Some sort of code sync to allow version control is needed for OpenFn to be a robust solution for low and non-technical implementers. Is there a way to enable GitHub sync for self-hosted instances? If not, is there a best… --- ## [Self host openFN](https://community.openfn.org/t/self-host-openfn/174)
**Author:** [@djibril](https://community.openfn.org/u/djibril)\ **Replies:** 9\ **Last updated:** [August 28, 2024, 12:10pm UTC](https://community.openfn.org/t/self-host-openfn/174 "2024-08-28T12:10:46Z")
Hello Guys. I would like to know if there is a documentation on how to self host openFN. meaning if there a software I can download and install it on my own servers. Thank for your help --- ## [Openfn/ws-worker:latest docker restarts](https://community.openfn.org/t/openfn-ws-worker-latest-docker-restarts/475)
**Author:** [@evertb](https://community.openfn.org/u/evertb)\ **Replies:** 11\ **Last updated:** [August 23, 2024, 6:30am UTC](https://community.openfn.org/t/openfn-ws-worker-latest-docker-restarts/475 "2024-08-23T06:30:30Z")
To whom this may concern. I have cloned the git repo and followed all steps to install via docker however the openfn/ws-worker:latest image (lightning-worker-1 docker name) keeps restarting. I have no errors when deploy… --- ## [Lightning prebuilt images throw: no matching manifest for linux/arm64/v8 in the manifest list entries](https://community.openfn.org/t/lightning-prebuilt-images-throw-no-matching-manifest-for-linux-arm64-v8-in-the-manifest-list-entries/465)
**Author:** [@jnsereko](https://community.openfn.org/u/jnsereko)\ **Replies:** 25\ **Last updated:** [July 30, 2024, 12:48pm UTC](https://community.openfn.org/t/lightning-prebuilt-images-throw-no-matching-manifest-for-linux-arm64-v8-in-the-manifest-list-entries/465 "2024-07-30T12:48:06Z")
hey @stu @taylordowns2000 I am running lightning on an M3 pro chip via docker compose? I am getting an error no matching manifest for linux/arm64/v8 in the manifest list entries which i suppress by specifying platform: … --- ## [Private/public key generation for self-hosted openFN](https://community.openfn.org/t/private-public-key-generation-for-self-hosted-openfn/454)
**Author:** [@ibrahimwickama](https://community.openfn.org/u/ibrahimwickama)\ **Replies:** 6\ **Last updated:** [June 20, 2024, 6:34am UTC](https://community.openfn.org/t/private-public-key-generation-for-self-hosted-openfn/454 "2024-06-20T06:34:45Z")
Hello team, I have tried using the production images, but i’m facing a challenge on private key public key on env file. How are this keys generated or do you already have predefined keys.? --- ## [Deploying Lightning : Stuck on loading workflows screen](https://community.openfn.org/t/deploying-lightning-stuck-on-loading-workflows-screen/425)
**Author:** [@Kiefer](https://community.openfn.org/u/Kiefer)\ **Replies:** 11\ **Last updated:** [April 22, 2024, 2:17pm UTC](https://community.openfn.org/t/deploying-lightning-stuck-on-loading-workflows-screen/425 "2024-04-22T14:17:11Z")
After successfully installing the lighning version locally and creating the project it then freezes on the loading workflows screen. I did an ispection of the page on the front end and thats the response i received. --- ## [Deploying lightning - error after adding asdf lines](https://community.openfn.org/t/deploying-lightning-error-after-adding-asdf-lines/422)
**Author:** [@aleksa-krolls](https://community.openfn.org/u/aleksa-krolls)\ **Replies:** 6\ **Last updated:** [April 2, 2024, 8:03pm UTC](https://community.openfn.org/t/deploying-lightning-error-after-adding-asdf-lines/422 "2024-04-02T20:03:06Z")
hey @taylordowns2000 @stu @rogerio we received the below query from @Kiefer and the os4h team. Can you assist? I am currently trying to install an OpenFn lightning instance via docker. I am following this documentation… --- ## [(DBConnection.ConnectionError) running a pre-built image ie openfn/lightning:v2.0.0-rc3](https://community.openfn.org/t/dbconnection-connectionerror-running-a-pre-built-image-ie-openfn-lightning-v2-0-0-rc3/396)
**Author:** [@jnsereko](https://community.openfn.org/u/jnsereko)\ **Replies:** 4\ **Last updated:** [February 26, 2024, 3:43am UTC](https://community.openfn.org/t/dbconnection-connectionerror-running-a-pre-built-image-ie-openfn-lightning-v2-0-0-rc3/396 "2024-02-26T03:43:36Z")
Hello Community! I am running Docker version 24.0.7, build afdd53b, and Docker Compose version v2.23.3-desktop.2 but i am getting an error (DBConnection.ConnectionError) connection not available and request was dropped… --- ## [Specs for self-hosting Lightning](https://community.openfn.org/t/specs-for-self-hosting-lightning/292)
**Author:** [@taylordowns2000](https://community.openfn.org/u/taylordowns2000)\ **Replies:** 0\ **Last updated:** [April 11, 2023, 3:47pm UTC](https://community.openfn.org/t/specs-for-self-hosting-lightning/292 "2023-04-11T15:47:27Z")
Note: Lightning (aka “OpenFn v2”) is the latest, fully open source version of OpenFn. OpenFn provides hosting-as-a-service and deployment-as-a-service for Lightning and lots of folks ask us how we do it. I’m starting th… --- ## [Exporting and Importing data](https://community.openfn.org/t/exporting-and-importing-data/342)
**Author:** [@mahaomolise92](https://community.openfn.org/u/mahaomolise92)\ **Replies:** 11\ **Last updated:** [August 28, 2023, 9:45am UTC](https://community.openfn.org/t/exporting-and-importing-data/342 "2023-08-28T09:45:55Z")
How do I export data from openfn lightning instance and import it to another instance. --- ## [Unable to setup locally in Mac M1 Laptop](https://community.openfn.org/t/unable-to-setup-locally-in-mac-m1-laptop/314)
**Author:** [@petach](https://community.openfn.org/u/petach)\ **Replies:** 6\ **Last updated:** [May 10, 2023, 7:19am UTC](https://community.openfn.org/t/unable-to-setup-locally-in-mac-m1-laptop/314 "2023-05-10T07:19:17Z")
Am using mac m1 chip, anytime I try to run mix lightning.install\_runtime I get this error: sh: /path\_to\_directory/Lightning/\_build/dev/lib/rambo/priv/rambo: No such file or directory \`\` when I go to \`Lightning/\_build/d… --- ## [Failed to run Lightning via Docker (Lightning #541)](https://community.openfn.org/t/failed-to-run-lightning-via-docker-lightning-541/275)
**Author:** [@Levi](https://community.openfn.org/u/Levi)\ **Replies:** 7\ **Last updated:** [March 29, 2023, 3:45pm UTC](https://community.openfn.org/t/failed-to-run-lightning-via-docker-lightning-541/275 "2023-03-29T15:45:42Z")
I was trying to follow the steps written in the README.md of OpenFn/Lightning When executing docker compose run --rm web mix ecto.migrate, I faced this error: =\> ERROR \[dev 14/18\] RUN mix openfn.install.runtime … --- ## [In Microservice, the job using "Flow" trigger always use the "configuration" from the previous Job even though it has its own credential](https://community.openfn.org/t/in-microservice-the-job-using-flow-trigger-always-use-the-configuration-from-the-previous-job-even-though-it-has-its-own-credential/234)
**Author:** [@Levi](https://community.openfn.org/u/Levi)\ **Replies:** 8\ **Last updated:** [September 21, 2022, 10:49am UTC](https://community.openfn.org/t/in-microservice-the-job-using-flow-trigger-always-use-the-configuration-from-the-previous-job-even-though-it-has-its-own-credential/234 "2022-09-21T10:49:40Z")
Let’s say: Job A, assigned with Credential A, the trigger is cron every 5 minutes Job B, assigned with Credential B, the trigger is “Flow” trigger of Job A I’ve tried this in the platform, it works correctly, the Job … --- ## [Failed to connect: \*\* (DBConnection.ConnectionError)](https://community.openfn.org/t/failed-to-connect-dbconnection-connectionerror/225)
**Author:** [@mtuchi](https://community.openfn.org/u/mtuchi)\ **Replies:** 0\ **Last updated:** [August 22, 2022, 12:36pm UTC](https://community.openfn.org/t/failed-to-connect-dbconnection-connectionerror/225 "2022-08-22T12:36:10Z")
Database setup If your having this error \[error\] Postgrex.Protocol (#PID\<0.637.0\>) failed to connect: \*\* (DBConnection.ConnectionError) tcp connect (${POSTGRES\_HOST}:5432): non-existing domain - :nxdomain Make sure in … [Next page](https://community.openfn.org/c/self-hosting/6.md?page=1)