Bricksync Installation

Vom gemieteten Server zum laufenden Sync. Eine Anleitung für Händler – ohne Fachchinesisch.

1 Die Vorbereitung

Sie haben gerade einen VPS Server gemietet (z.B. bei Strato, Ionos oder Hetzner). Was nun? Bevor wir starten, legen wir uns alles bereit.

Ihre Checkliste (bitte bereithalten):

Die E-Mail Ihres Anbieters:
Suchen Sie nach einer Mail mit dem Betreff "Ihr Server ist bereit" oder "Zugangsdaten".
Darin finden Sie die IP-Adresse (z.B. 85.214.12.34).

Das Root-Passwort:
Entweder steht es in der Mail, oder Sie mussten es beim Bestellen des Servers selbst festlegen. Das ist der "Generalschlüssel".

Das Programm "Putty" (nur für Windows):
Damit steuern wir den Server. Laden Sie es hier kostenlos herunter:
Download Putty (Wählen Sie die Datei putty-64bit... .msi).

2 Der erste Login

Jetzt verbinden wir uns mit dem Server. Starten Sie das Programm Putty.

So stellen Sie Putty ein:

PuTTY Configuration

Host Name (or IP address):

85.xxx.xxx.xx

← Hier Ihre IP-Adresse aus der E-Mail eintippen

← Klicken Sie unten auf "Open"

Das schwarze Fenster öffnet sich

Es erscheint möglicherweise eine Sicherheitswarnung ("Security Alert"). Klicken Sie auf "Accept" oder "Ja".

Nun steht dort: login as:

1. Tippen Sie root ein und drücken Sie Enter.

2. Nun steht dort: root@... password:

WICHTIG - BITTE LESEN:
Wenn Sie jetzt Ihr Passwort eintippen, bewegt sich der Cursor nicht. Es erscheinen keine Sternchen (****). Das ist normal bei Linux! Tippen Sie das Passwort einfach "blind" ein und drücken Sie danach Enter.

Wenn dort nun Text erscheint und am Ende ein blinkender Cursor steht, sind Sie drin! Herzlichen Glückwunsch, der schwerste Teil ist geschafft.

3 Sicherer Benutzer

Aktuell sind Sie als "Chef" (Root) angemeldet. Das ist unsicher. Wir erstellen nun einen normalen Benutzer für Bricksync.

Kopieren Sie den Befehl (Klick auf den Button) und fügen Sie ihn in Putty ein (einfacher Rechtsklick ins schwarze Fenster und Enter drücken).

sudo adduser bricksync

Vergeben Sie ein Passwort für den neuen Nutzer. Die Abfragen nach Namen etc. können Sie einfach mit Enter überspringen.

Geben Sie dem Nutzer Rechte:

sudo usermod -aG sudo bricksync

Melden Sie sich als der neue Nutzer an:

su - bricksync

Links sollte nun bricksync@... stehen.

4 Installation

Wir installieren erst Hilfsprogramme und laden dann Bricksync herunter.

1. Werkzeuge installieren:

sudo apt update && sudo apt install unzip screen wget nano -y

2. Bricksync herunterladen (Stand 01/2026):

wget https://github.com/ZZJHONS/Bricksync/releases/download/v1.7.4-250721/bricksync-linux64.zip

3. Entpacken:

unzip bricksync-linux64.zip

4. Die Programmdatei entpacken:

tar xvfz bricksync-linux64-1.7.4-42.tar.gz

Tipp: Falls "File not found" erscheint, tippen Sie ls um den genauen aktuellen Dateinamen zu prüfen.

5. Aufräumen:

rm bricksync-linux64.zip && rm bricksync-linux64-1.7.4-42.tar.gz

5 Konfiguration

Nun müssen Sie Ihre BrickLink/BrickOwl Zugangsdaten eintragen. Wir nutzen dafür den einfachen Texteditor "Nano" direkt auf dem Server.

cd bricksync-linux64/data
nano bricksync.conf

So bedienen Sie Nano:
1. Bewegen Sie sich mit den Pfeiltasten zu den Zeilen für die API Keys.
2. Fügen Sie Ihre Keys ein (Rechtsklick in Putty).
3. Speichern: Drücken Sie STRG + O (Buchstabe O), dann Enter.
4. Beenden: Drücken Sie STRG + X.

6 Starten

Damit Bricksync weiterläuft, wenn Sie Putty schließen, nutzen wir das Programm "Screen".

cd ..
screen

(Einfach Enter drücken, falls Screen beim Starten einen Infotext anzeigt).

Bricksync starten:

./bricksync

So schließen Sie Putty richtig:
Damit der Server an bleibt und Bricksync weiterläuft: Drücken Sie STRG + A, lassen Sie los, und drücken Sie D.
Bricksync läuft nun im Hintergrund ("Detached"). Jetzt können Sie das Putty-Fenster sicher schließen.

7 Später prüfen

Sie wollen morgen schauen, ob alles läuft?

Putty starten & einloggen.
Befehl: su - bricksync
Befehl: screen -r

Schon sehen Sie wieder das laufende Bricksync-Fenster.