Basic demo setup for WuttaFarm
  • Shell 69.4%
  • Dockerfile 15.8%
  • Python 14.8%
Find a file
2026-11-15 21:24:06 -06:00
farmos add restart policy for all container services 2026-11-15 21:24:06 -06:00
wuttafarm add restart policy for all container services 2026-11-15 21:24:06 -06:00
.gitignore add host volume for wuttafarm cache dir 2026-11-01 13:04:33 -06:00
README.md improve readme now that everything works 2026-10-30 22:39:21 -05:00
shared-env set local timezone for both apps based on env 2026-11-01 20:27:11 -06:00

farmOS/WuttaFarm Demo

This project includes scripts to run farmOS and/or WuttaFarm software, in 4 different "demo" configurations:

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):

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 1
  • alice - farm manager
  • bob - farm worker
  • charlie - 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.)