RaiseCloud Plugin Installation Manual

1. Required tools

(1)SD Card(No less than 8 GB)

(2)SD Card Reader

(3)Raspberry Pi 3b+

(4)SD Card formatting tool(formats the SD Card and lets the SD Card act as a start-up disk)

Download address: https://www.sdcard.org/downloads/formatter/eula_windows/

Select the appropriate version.

Click “Accept” to download.

(5)Win32DiskImager (writes an image to the SD Card)

Download address: https://sourceforge.net/projects/win32diskimager/ 

(6)OctoPi(the OctoPrint image)

Download address: (Download without registration) https://github.com/guysoft/OctoPi 

2. Install the OctoPrint

(1) Format SD Card

After connecting the SD Card to your computer,open the formatting software, select the SD Card where the disk character is located and click “Format” for format.

Use win32DiskImager to install the image (Octopi) onto the SD Card.

(2)Flash the image

UnZip the image you have downloaded. Open the win32diskimager and select the unzipped image 2019-09-26-octopi-buster-lite-0.17.0. Select the SD card disk. After clicking on the write button, wait for the system image to be written to the SD Card.


After writing, do not rush to unplug the SD card. In the computer, you can see a partition called boot (this partition is FAT32 format, and the capacity will be very small. This is normal. After the SD card is inserted into Raspberry Pi, this boot partition is the system /boot folder)

Open the cmdline.txt in the boot disk. Set the static IP for Raspberry Pi to facilitate access to OctoPrint within the LAN.

Open the cmdline.txt file with Notepad and add 

ip=xxx.xxx.xxx.xxx dwc_otg.fiq_enable = 1 dwc_otg.fiq_fsm_enable = 1 dwc_otg.fiq_fsm_mask=0x3 in the first line. After the setting is completed, save the file and eject the SD card.

Note: Each field should be separated by a space. When setting the IP, please the first query the network segment where the LAN is located, and then add a LAN IP.

The cmdline.txt file is as follows:

After the SD card is ejected, insert the SD card into the SD card slot of the Raspberry Pi, and connect the power cable and network cable to the Raspberry Pi. Use a USB cable to connect the printer to the Raspberry Pi.

3. Configure a local OctoPrint account

Turn on the Raspberry Pi, enter the previously configured address ( in the browser and log in to OctoPrint. It takes a few minutes for the Raspberry Pi to start, please try to refresh the page after a few minutes.

According to the interface wizard, complete the registration and setup. When you're done, select Serial Port, Baudrate, and then Printer in the interface. Then click “Connect” to connect to the printer.

The final picture is as follows: 

Note: (1)The state is initially “off-line”. Once a connection is successfully made, the state will become “Operational”. Please wait patiently for the connection.

(2)Please check the options "Save connection Settings" and "Auto connect on server startup" to ensure that the printer will be connected automatically next time when service restarts.

4. Install the RaiseCloud Plugin

(1) Click the wrench icon on the interface and select the Plugin Manager.

(2) If the following interface appears, perform the following steps. If not, move to step (3).

Click the settings button in the image above.

Then click the save button below. Wait for a while and proceed to the next step.

(3)To open OctoPrint settings, select Plugin Manager in the interface.

Click get more, enter the address https://github.com/Raise3D/OctoPrint-Raisecloud/archive/master.zip, click install.

Note: The installation may fail. And if the installation fails, please repeat this step.

(4)Now restart the OctoPrint service. After restarting, select RaiseCloud under the PLUGINS window and the following interface will appear.

Now go back to the RaiseCloud page, find the 3D Printer Binding Key file in the lower-left corner and download it for plugin login.

Go back to the OctoPrint page, after uploading the Key file. After clicking on the agree to privacy policy button, click the Bind button to log in and the following interface will be displayed.

The printer Name is the current printer name. You can click to modify it. After the modification, it will be updated in your RaiseCloud account. Clicking the Unbind button will force you to log out, and the printer will be offline.

5. Update RaiseCloud Plugin

To update the plugin, select settings in the OctoPrint interface and find the Plugin Manager option. Then find the Plug Cloud plugin and click on the delete button on the right.

Then click Get More, input: https://github.com/Raise3D/OctoPrint-Raisecloud/archive/master.zip

After successfully installing, restart OctoPrint.