- Shell 69.4%
- Dockerfile 15.8%
- Python 14.8%
| farmos | ||
| wuttafarm | ||
| .gitignore | ||
| README.md | ||
| shared-env | ||
farmOS/WuttaFarm Demo
This project includes scripts to run farmOS and/or WuttaFarm software, in 4 different "demo" configurations:
- farmos - only farmOS
- wuttafarm/standalone - only WuttaFarm
- wuttafarm/wrapper - WuttaFarm as "alternative UI" to farmOS
- wuttafarm/mirror - WuttaFarm as "synced peer" with farmOS
This is designed for local/dev use only - certain config used is not safe for production.
Usage
You must have Docker Compose installed for this to work.
Clone the repo, change to the desired setup folder (any of the 4
listed above), and run its start.sh script:
git clone https://forgejo.wuttaproject.org/lance/wuttafarm-demo.git
cd wuttafarm-demo/farmos
./start.sh
This builds a docker image(s) on the fly, so the first attempt may
take a few minutes. It might even fail; if so just run start.sh
again and probably the 2nd time works.
Once it's running you can browse the app URL(s):
- http://localhost:7277 - farmOS
- http://localhost:7278 - WuttaFarm
Due to the common port config, only one of the 4 setups should be running at any time. However each uses separate data volumes so they won't interfere with each other in that regard.
The following user accounts are setup by default (in both apps), with
password set to letmein for each:
admin- UID 1alice- farm managerbob- farm workercharlie- farm viewer
When you're done and want to cleanup, run the folder's destroy.sh
script:
./destroy.sh
Known Issues
For all WuttaFarm setups, none of the asset/log attached images will display, due to technical details of how the demo setups work. (It can work okay in a production setup.)
For the wuttafarm/wrapper setup, there can be a problem if you
delete an asset from WuttaFarm, which is still referenced by (e.g.) a
log. farmOS would not let you do this, but WuttaFarm isn't that smart
yet. It will act like it worked but delete will not really happen.
Also for wuttafarm/wrapper setup, if you login to WuttaFarm as
admin user, the top menu looks like everything should be accessible
to you. And as far as WuttaFarm is concerned, you would have
access. But the farmOS API is preventing it (IIUC), so you'll have
better luck with the alice login for the actual farm data. (However
you can still login to WF as admin to manage user accounts etc. -
basically non-farm data.)