Branding Repetier-Server

Corona Virus banner illustration – Microbiology And Virology Concept – by Mike Fouque

We offer manufacturers and vendors the possibility to create a custom branding for Repetier-Server with own name, logo and colors and to distribute this customized version to their customers. For this a license code is required in any case. On request we offer licence codes for resellers at reduced rates.

Below we will show how you can create your own branding:

The normal startup configuration can be found here:

Linux:   /usr/local/Repetier-Server/etc/RepetierServer.xml

Windows: C:\Program Files (x86)\Repetier-Server\bin\RepetierServer.xml

Mac:     /usr/local/Repetier-Server/etc/RepetierServer.xml

This startup configuration is overwritten when updating, so please do not make any changes here. Just create the file RepetierServer-extra.xml in the same folder. All data provided herein have priority and override the default settings. Identical entries should not be repeated, because they have priority and could cause problems with updates.

So lets get started. First you create a shadow folder, where you can replace the original files like images or css files. Please notice that you must have to use the same folder structure as in this folder:

Linux:   /usr/local/Repetier-Server/www

Windows: C:\Program Files (x86)\Repetier-Server\www

Mac:     /usr/local/Repetier-Server/www

In my windows example I create the folder C:\Repetier-Server-Shadow, everything I put in here will replace the original files.

Then I create the file RepetierServer-extra.xml >in C:\Program Files (x86)\Repetier-Server\bin\ with this content:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
        <branded-name>Your Server Name</branded-name>

Set <shadow-www-directory>C:\Repetier-Server-Shadow</shadow-www-directory> to your shadow folder. With ><branded-name>Your Server Name</branded-name> you can define the program name.

To replace the logo, go to your shadow directory and create the folder img. The logo file name is logo-60.png. If you copy an image with this name into this folder, the logo will be replaced.

To replace the favicon.ico copy your new image to C:\Repetier-Server-Shadow.

Starting with version 0.93.2 you can also add extra links to the .xml file. To add them add below the <server> tag a link like this:
<extra-url href="">Repetier Forum</extra-url>
In the regular gui the links appear in the server dropdown menu. In Repetier-Server Monitor they will appear in the printer context menu.

To see the changes, you have to restart Repetier-Server. The easiest way is to do this in Repetier-Host. Select Server -> Stop Local Server and than Server -> Start Local Server.

Now your Repetier-Server looks like this:

Color Adjustment

Replacing program name and icons is very easy. If you want to use your own colors, you need some more time. Remember that with new versions these css files often get changed, so you should always adjust the color changes for updates. If you want to spare you this work, simply use the default color scheme.

Of course you can copy the css file C:\Program Files (x86)\Repetier-Server\www\css\combined.css to C:\Repetier-Server-Shadow\css and make some changes, but when you see this file, it is not really the easy way and will make more problems than needed.

Therefore we use less files to create combined.css, which makes this work much easier.

To get started, you should download our Repetier-Server-Shadow and use this as starting point. Replace or remove all images.

Then install WinLess and add the folder C:\Repetier-Server-Shadow\css o WinLess. Here you select just the file combined.less as on the next image:

Now you can open and edit the file C:\Repetier-Server-Shadow\css\server\origvars.less. To build a new combined.css, open WinLess and click Compile. To see the changes in Repetier-Server, just reload the page.

So now you have set your colors. But remember to do this for every update. To avoid problems, you should use your own update info file. You have to add the red line to your RepetierServer-extra.xml.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
        <branded-name>Your Server Name</branded-name>

Your updateinfo.txt should look like this:



## New features
* Describe new fetures here

The file must have the following format:

Line 1: Current version number
Line 2: Download URL on your web site
Line 3: Direct download URL
Line 4: Update type (1 = Debian package, 4 = Mac PKG, 6 = Windows exe installer)
Line 5: sha1sum of the file in Line 3
Line 6 – 8: Have to be empty
Starting line 9: Update info that is displayed in the server

To get the sha1sum of your package open the storage folder in Linux and enter:

sha1sum Repetier-Server-0.65.0-Linux.deb

Then you will get the sha1sum:
313c62990c6bfec998c48bb6d81704ce2852cf01 Repetier-Server-0.65.0-Linux.deb

How to add a preconfigured printer

Of course you can add your printer configurations to your installer, so that your customors can use them after installation. The only thing you have to do is to add the config file for your printers. You will find these xml files here:

Linux:   /var/lib/Repetier-Server/configs
Windows: C:\ProgramData\Repetier-Server\configs
Mac:     /Library/Application Support/Repetier-Server/configs

Each printer has its own xml file where everything is stored. If you add this to your installer, the other needed folders will be created automatically. But before you add them, you should remove all personal settings as special G-Codes scripts and webcam settings. So the only thing your customor has to do is to set the port.

For updates, you should adjust the installer that this file will not be overwritten if it already exists, otherwise the customer’s personal settings get deleted!

Important to notice!!!

You should move your shadow-www-directory to the installation folder and adjust your RepetierServer-extra.xml. It does not make sense to create a separate folder structure for this.

Notice for making an image: You have to stop the server and delete this file:

Linux:   /var/lib/Repetier-Server/database/settings.sql
Windows: C:\ProgramData\Repetier-Server\database\settings.sql
Mac:     /Library/Application Support/Repetier-Server/database/settings.sql

In settings.sql are your api key and personal settings stored, so this will definitley cause many problems and security issues!!!

Also you never should include the user.sql, that can be found in the same folder. Here are your logins and encrypted passwords stored, so this will also cause problems.

Further Customizations

If your printer has a touchscreen, this might interrest you:

Printer Touchscreen Customization

If you want to extend our web frontend, you will find detailed information here:

Repetier-Server Module System
Repetier-Server API description