Een server koppelen met één commando

Je koppelt een Linux-server aan ServerScope met één commando. Het script installeert de agent, wisselt een eenmalig koppeltoken in voor een eigen agenttoken en wacht tot de eerste meting binnen is.

Vereisten#

• Ubuntu 22.04 of nieuwer, of Debian 12 of nieuwer
• Processor amd64 of arm64
• systemd (de agent draait als systemd-service)
• Een gebruiker met sudo-rechten
• Uitgaand HTTPS-verkeer van de server naar https://serverscope.nl
• In ServerScope: de rol eigenaar of beheerder in je team

Past je server niet bij deze vereisten? Bekijk dan de handmatige installatie.

1. Een koppeltoken aanmaken#

Open in ServerScope Servers → Server toevoegen → Linux → Koppeltoken aanmaken. De pagina toont het installatiecommando en een koppeltoken.

• Het token is 60 minuten geldig en werkt één keer.
• Je kunt een token op dezelfde pagina intrekken.
• ServerScope bewaart alleen een hash van het token.

2. Het commando uitvoeren#

Voer op de server uit:

curl --proto '=https' --tlsv1.2 -fsSL https://serverscope.nl/install.sh -o serverscope-install.sh && sudo bash serverscope-install.sh

Wil je het script eerst lezen? Open https://serverscope.nl/install.sh in je browser. Het installeert software als root.

3. Het koppeltoken plakken#

Het script vraagt om het koppeltoken. De invoer is verborgen. Het token zit bewust niet in het commando, zodat het niet in je shellgeschiedenis of in de proceslijst terechtkomt.

Tip

Automatiseer je de installatie? Zet het token dan in de omgevingsvariabele SERVERSCOPE_ENROLL_TOKEN, bijvoorbeeld uit een secret store. Typ het niet op de commandoregel.

Het script wacht op de eerste meting. Daarna staat de server als online in het dashboard van het team dat het token maakte. De pagina in ServerScope laat live zien wanneer de server verbonden is.

Wat het script doet#

• Het stopt op alles behalve Ubuntu 22.04+ of Debian 12+ op amd64 of arm64 met systemd.
• Het installeert python3, python3-venv, python3-psutil, python3-requests en python3-dotenv uit de pakketbronnen van je distributie (geen pip, geen PyPI) en maakt een virtuele Python-omgeving.
• Het maakt de systeemgebruiker serverscope zonder shell aan (als die nog niet bestaat).
• Het downloadt het agentpakket en de bijbehorende SHA-256-controlesom van ServerScope, alleen via HTTPS (TLS 1.2 of hoger), en controleert de controlesom.
• Het installeert de agent in /opt/serverscope-agent, met de configuratie in /opt/serverscope-agent/.env (eigenaar root:serverscope, rechten 640).
• Het wisselt het koppeltoken in voor een normaal agenttoken, start de service serverscope-agent en wacht maximaal 90 seconden op de eerste meting.

Opmerking

De controlesom komt van dezelfde server als het pakket. Ze beschermt tegen een beschadigde of afgebroken download, niet tegen een gecompromitteerde ServerScope-server.

Opnieuw draaien#

Het script opnieuw draaien is veilig:

• Een installatie die door het script is gemaakt en een werkend agenttoken heeft, wordt alleen bijgewerkt. Er komt geen tweede server bij.
• Is het agenttoken ingetrokken, dan vraagt het script om een nieuw koppeltoken en maakt het een nieuwe server aan. Verwijder de oude server daarna in het dashboard; de historie blijft tot je dat doet.
• Een agent die je handmatig hebt geïnstalleerd, laat het script ongemoeid.

Verwijderen#

sudo bash serverscope-install.sh --uninstall

Dit trekt het eigen agenttoken in bij ServerScope, stopt en verwijdert de service, verwijdert /opt/serverscope-agent en verwijdert de gebruiker serverscope als het script die heeft gemaakt. De server en zijn historie blijven in ServerScope. De Python-pakketten uit apt blijven staan.

Problemen oplossen#

Het script stopt met een melding in het Nederlands en een oplossing. De meest voorkomende:

Het logboek van de agent bekijk je met:

journalctl -u serverscope-agent -n 50