Python JavaScript CSS HTML C++
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
.editorconfig use tab for python files Aug 11, 2016

AstroBox Software

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

Reporting bugs

Our issue tracker can be found on Github.

Installation instructions

  • Create an bootable image using the images from AstroPrint

  • Download the source code to get a working copy:

      git clone

Additional (to run from source):


  sudo apt-get install rubygems oracle-java8-jdk


  gem install rubygems-update

Download and install oracle-java8-jdk from here.


  $ 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

Setting up the virtual printer

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 or create, the printer-profile.yaml file in your settings directory (by default [AstroBox Directory]/local). Change or add the line:
  driver: 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