8d57a478be
* split * split2 * more splitting * working * towards working * menu changes * run through prepare * minorfix * octoprint_generic * break in template * replace daemonpath with octoexec * move first install to instance * move BASE to instance * instance fix * double period * damn loop! * add camera to deploy * fix camera * toward functional * main_menu if not ready * not equal or -ne? * template copy * clean ups * byid camera detect * do byid detect by default * classwebcam * classicwebcam * appned_value camera work * use users for modification in cameras * fancy colors * updating colors * status menu colors and cams * surpress errors on no files * remove most logging * dnf mods * selinux * redirect error output to /dev/null * package cleanup * remove udev, cloud * octopi update * resource prepare from menu * quick fix * pacman fix * more echos * add udev flag in /etc/octoprint_deploy * opensuse fixes * zypper, minor fixes * change_streamer * diagnostics, octoprint_cameras, etc * diagnostic menu * logging for diagnostics * add config.yaml to diagnostics * add logging for config.yaml * readme work, add deb_pacakges for octopi, * README * port fixing * port fixes * add deb_packages command for troubleshooting * fix ports * add octopi flag, I fucking hate octopi * udev rule work * add/remove udev * menu fix * menu fixes * add detect printer for add_udev * better detection for remove_udev * remove udev * working on sed for udev * fixed udev remove * camera udev * add instace to add_udev_camera * readme, cleanup * choose what parts of template to copy * rsync as user * additionalPorts * remove cameras from camera list
Updated June 24, 2023.
Want to support this work? Buy Me a Coffee. https://www.buymeacoffee.com/ppaukstelis. Need help with octoprint_deploy? Ask on Discord: https://discord.gg/6vgSjgvR6u
octoprint_deploy 1.0.0 - ALL NEW
- These files provide a bash script for quickly deploying multiple octoprint instances on a single computer. For Linux systems (Ubuntu, Fedora, etc.) it will also install OctoPrint and a video streamer (ustreamer). No need for lots of file editing or complicated Docker compose scripts! A background video on how it generally works from my ERRF2022 talk can be found here: https://www.youtube.com/watch?v=q0iCNl8-kJI&t=15378s
- octoprint_deploy and octoprint_install are being merged! Maintaining two separate scripts was close to twice the amount of work. By merging the scripts many new features have been included, while also providing greater simplicity in setup. For now, the merged script will be called octoprint_deploy and at some point the octoprint_install repository will point here.
- The biggest change is that there is no longer the notion of a single 'template' OctoPrint instance. Now, any previously configured instance can be used as a template when a new instance is created. The choice is up to the user.
- Unfortunately, octoprint_deploy > 1.0.0 is not directly compatible with older versions, as so much has changed. If you want to use the new version of octoprint_deploy with an older setup, create backups (either with OctoPrint UI or with octoprint_deploy), then use the
removecommandline argument before updating octoprint_deploy. Re-make your instances using the same instance names, then recover your backups.
How to use
- OctoPi
- OctoPi is intended as a single printer environment. This script makes adding multiple instances easy, but it cannot take into account everything OctoPi does (mostly surrounding cameras). You have been warned.
- ssh into your Pi (pi@octopi.local; good idea to change your password now!).
- run the command
git clone https://github.com/paukstelis/octoprint_deploy. - run the command
sudo octoprint_deploy/octoprint_deploy.sh. - Choose
Prepare Systemfrom the menu.- This will register the OctoPi-created instance in octoprint_deploy.
- You will be prompted for udev detection (only needed if you are adding multiple printers).
- You will be prompted for installing a new streamer. This will be the default streamer for any additional cameras that are installed.
- To add more printers choose
Add Instanceand follow the instructions.- You will be asked if you want to use an existing instance as a template. This will copy all files from this existing instance to your new instance.
- If your printer does not have a serial number (all Creality printers), it will detect and use the physical USB address for udev entries.
- Continue until you have added all the printers you want to use.
- haproxy entries are updated so you can connect via http://octopi.local/instancename
- To add more printers at a later date, just run the script again!
- Want to use a Pi camera? After you have made your instance(s), run the script with
sudo octoprint_deploy/octoprint_deploy.sh picamand follow the instructions (VERY EXPERIMENTAL).
- General Linux (Ubuntu/Mint/RPiOS/Debian/Fedora/Arch/etc.)
- You do not need to install OctoPrint using any Wiki instructions, snap, etc. The script will do it all for you.
- octoprint_deploy uses systemd services, so avoid distros that do not use systemd by default (MX Linux or chroot based systems like Chrome+crouton)
- All commands assume you are operating out of your home directory.
- Install Ubuntu 20+, Mint 20.3+, Debian, DietPi, RPiOS, Armbian, Fedora35+, ArchLinux, or openSUSE on your system (make sure your user is admin for sudo).
- Install git if it isn't already:
sudo apt install gitorsudo dnf install gitorsudo pacman -S gitorsudo zypper in git. - run the command
git clone https://github.com/paukstelis/octoprint_deploy. - run the command
sudo octoprint_deploy/octoprint_deploy.sh. - Choose
Prepare Systemfrom the menu. Select your distribution type. All deb-based system use the same selection. This will install necessary packages, install OctoPrint, and prompt you to create the first instance.- You will be asked if you want to use haproxy. This will make your instances available on port 80 e.g. http://hostname.local/instancename/
- You will be asked which streamer you would like to install (ustreamer, mjpg-streamer or camera-streamer). Please note, not all distributions will be compatible with camera-streamer.
- You will be prompted if you want to setup the admin user and do the first run wizard via the commandline.
- You will be prompted if you want to install recommended plugins.
- Continue with octoprint_deploy script, choose
Add Instanceand follow the instructions.- If your printer does not have a serial number (all Creality printers) it will be detected by the USB port you plugged it in to.
- You can also setup a camera for the instance at this time. Follow the instructions.
- Add as many instances as you have printers, following the instructions.
- To add more printers at a later date, or to add cameras to an instance later, simply run the script again (
sudo octoprint_deploy/octoprint_deploy.sh) and choose the appropriate option.
- Other features from commandline arguments
- Want to get rid of everything?
sudo octoprint_deploy/octoprint_deploy.sh remove - Backup and restore files for an instance from the menu, or backup all instances with
sudo octoprint_deploy/octoprint_deploy backup - Restart all instances from the command line:
sudo octoprint_deploy/octoprint_deploy.sh restart_all
- Want to get rid of everything?
Recent Changes
- Lots of changes, now octoprint_deploy 1.0.0
- Udev utility menu
- Diagnostic information from menu provides a variety of useful information about the system.
- Cameras have additional fallback detection (/dev/v4l/by-id entries)
TODO
- Integration with OctoPi new camera stack. This may or may not happen.
- Detection of existing instances/binaries that can be used instead of a full install (preserves plugins)