OctoFarm

OctoFarm is a single pane of glass that combines multiple OctoPrint instances into a single interface. It utilises the OctoPrint API and websocket systems to monitor and allow management of your 3d printer farm.

A free and open source makers farm management software
Explore the documentation

· Report a bug · Request a feature or ask a question

• About OctoFarm
• Need help?
• Getting Started
• Installation Production
• Installation Development
• License
• Contact
• Acknowledgements

About OctoFarm

OctoFarm was built to fill a need that anyone with multiple 3D printers with Octoprint will have run into. How do I manage multiple printers from one place? That's where OctoFarm steps in, add your OctoPrint instances to the system and it will scan and keep you up to date on the status of your printers.

Built by a maker, for makers to get more out of their OctoPrint run farms.

• Manager your OctoPrint instances right down to triggering Updates and Plugin installs.
• Keep a track of all the live data on your farm with a selection of views.
• Manage your OctoPrint file system.
• Get an overview of your farm with the customisable dashboard.
• Manage and track filament on your farm.
• Track history and logs for all of your instances.
• Supports a wide variety of OctoPrint plugins to augment the OctoFarm system with more information.

Need help?

Feel free to join any of the OctoFarm communities or follow OctoFarms progress on it's blog.

• OctoFarms Website
• OctoFarms Documentation
• OctoFarm Blog
• Community Support on Facebook
• Community Support on Discord
• General Question or Feature Request?
• Fancy donating to the project?

Getting Started

Before installing it is best to read the getting started documents here: Getting Started

Installation Production

Check out the OctoFarm documentation website for installation instructions on various platforms Getting Started

Installation Development

1. Clone the OctoFarm

git clone https://github.com/NotExpectedYet/OctoFarm.git

2. Install the mono-repo eslint dependencies (eslint, prettier and nodemon)

npm install

3. Install server and client dependencies

npm run setup-dev

4. Create an .env file in the OctoFarm folder's root directory. e.g. OctoFarm/.env. Paste in the contents below.

NODE_ENV=development
MONGO=mongodb://127.0.0.1:27017/octofarm
OCTOFARM_PORT=4000

5. Build the latest client

npm run build-client

6. (Optional): Watch for client changes, requires a secondary console.

npm run dev-client

7. Start the server

npm run server-dev

• The developer version uses nodemon for live server reloading on changes. It will output all the logs to the console.

License

This work is licensed under the GNU Affero General Public License v3.

Contact

You can contact me at info@notexpectedyet.com

Acknowledgements

• My Patreons - You all keep me going and afford me a financial incentive to keep OctoFarm up to date with new features and fixes! Biggest thanks of all.
• Gina Häußge - Without OctoPrint none of this would be possible. Massive thanks to the work of Gina and everyone who helps out with that.
• Derek from 3D Printed Debris - Massive big thanks to Derek who has donated a lot of time and money to the project. I don't think I'd have continued at the rate I did without his bug reports and support.
• JetBrains IDE - Thanks to JebBrains for allowing a free license to use with developing my application. Their IDE is top notch!