The AstroBox software provides a responsive web interface for controlling a 3D printer (RepRap, Ultimaker, ...) and connecting to the AstroPrint cloud for easy 3D Printing anywhere. It is Free Software and released under the GNU Affero General Public License V3.

This project started as a fork of OctoPrint. Many thanks to Gina and all the great contributors there that made the AstroBox software possible.

Its website can be found at astroprint.com.

Our issue tracker can be found on Github.

• Create an bootable image using the images from AstroPrint

• Download the source code for getting your working copy:

    git clone https://github.com/AstroPrint/AstroBox.git
  

• If you intent to run from source, you also need to install:

    $ sudo apt-get install rubygems oracle-java8-jdk
    $ sudo gem install sass 
    $ sudo pip install -r requirements.txt
  

• You can run the box from source like this:

    $ sudo service astrobox stop
    $ sudo python ./run --config /etc/astrobox/config.yaml --host 127.0.0.1
  

The AstroBox Software comes with a handy virtual printer so that you can test without the need of a real 3D Printer attached. Here's how you can set it up

• Edit the printer-profile.yaml file in your settings directory (by default [AstroBox Directory]/local). Change the driver property to virtual.

• Edit or create the virtual-printer-settings.yaml file in the same directory to guide your printing simulation. All values are in seconds. Here's a sample:

connection: 3.0
heatingUp: 5.0
printJob: 10.0

• Restart AstroBox any time you make changes to these files