What's in it for me?
By following this tutorial, you'll see how easy it is to deploy web applications to Golem.
You should be able to complete it regardless of your level of experience. However, it will help if you have some fluency using basic unix tools like
git and are not afraid of running console commands.
To launch applications on Golem, you request computational resources from the network. Therefore, you need the following prerequisites prior to execution:
- a running
yagnadaemon (v0.12 or higher)
- your requestor app key
Setting these up is a part of the tutorial linked below. You only need to complete the first part, and omit "Run first task on Golem". Once you have your yagna daemon running and your application key copied, feel free to proceed here.
Requestor development: a quick primer
Please also ensure you have
curl available on your system.
If not, please install it using the instructions appropriate for your system from: https://curl.se/download.html.
Get the virtual environment set up
It's best to run any Python applications in a virtual environment so as not to clutter your system's Python installation with unnecessary packages.
Ensure you're running Python >= 3.8, and you have the
venv module installed (it's normally included in the Python distribution).
Prepare a virtual environment for the tutorial script:
On Windows in the regular
cmd shell, you need to replace the above with:
The tool which deploys apps to Golem,
dapp-runner is installable from the PyPi repository with the following command:
Running a dApp on Golem
Get the sample app
curl https://raw.githubusercontent.com/golemfactory/dapp-store/81e3f50aba90a84d335a26cb9cc2ea778193be11/apps/todo-app.yaml > webapp.yaml
And the default config file
curl https://raw.githubusercontent.com/golemfactory/dapp-runner/main/configs/default.yaml > config.yaml
Export your application key to the environment
Run the app
Having the above setup complete, you can verify it by running a sample application that comes together with
dapp-runner repository using the following commands:
Once the app is deployed on Golem, you should see a line reading:
This means that the app is ready and can be viewed at: http://localhost:8080
(The port on your machine may be different)
Now that you've been able to experience launching decentralized apps on Golem, you might wish to learn what it takes to build one yourself.