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:
Windows: C:\Program Files (x86)\Repetier-Server\bin\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:
Windows: C:\Program Files (x86)\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
C:\Program Files (x86)\Repetier-Server\bin\ with this content:
<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
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="https://forum.repetier.com">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:
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 to 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
updateinfo.txt should look like this:
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:
Then you will get the sha1sum:
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:
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:
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.
If your printer has a touchscreen, this might interrest you:
If you want to extend our web frontend, you will find detailed information here: