Installera NetBox

Vad NetBox är

Ett register över teknisk utrustning och nät. Vilka datorer du har, vilka IP-adresser som är upptagna, vad som sitter i vilken kontakt, och vem som ansvarar för vad. Allt på ett ställe i stället för i tre kalkylark och ett huvud.

Det låter tråkigt tills första gången någon frågar vilken adress skrivaren har och ingen vet. Eller tills två personer råkar ge samma IP-adress till varsin maskin och halva nätet slutar fungera. NetBox finns för att den sortens frågor ska ha ett svar.

För de flesta företag är det här ett för stort verktyg. Det blir intressant om du gör något åt IT-hållet, till exempel hjälper en förening eller ett företag med deras utrustning, för då är registret en del av tjänsten du säljer.

Det här är ett serverprogram

NetBox installeras inte som ett vanligt program. Det är en webbtjänst som körs i containrar och som du når via webbläsaren. Verktyget som kör dem är Docker, samma som i Installera Docker. Har du inte Docker på plats, börja där och kom tillbaka hit.

På Windows innebär Docker Desktop att du också får WSL2, alltså Windows inbyggda Linux. Docker Desktop installerar det normalt själv, men blir du tillfrågad ska du svara ja. Utan WSL2 startar ingen container.

Du behöver också git, alltså programmet som hämtar kod från nätet. Det följer inte med Windows, och det är där många fastnar på rad ett.

Windows

Installera git först. Öppna PowerShell och kör:

winget install Git.Git

Stäng fönstret och öppna ett nytt, annars känner PowerShell inte igen kommandot ännu. Kör sedan de fyra raderna:

git clone -b release https://github.com/netbox-community/netbox-docker.git
cd netbox-docker
copy docker-compose.override.yml.example docker-compose.override.yml
docker compose up -d

Linux Mint

Samma sak, med två små skillnader. Git installeras med paketverktyget, och kopieringskommandot heter något annat. Öppna Terminal:

sudo apt-get install git
git clone -b release https://github.com/netbox-community/netbox-docker.git
cd netbox-docker
cp docker-compose.override.yml.example docker-compose.override.yml
docker compose up -d

Första starten tar flera minuter, för NetBox sätter upp sin databas innan den öppnar. Följ med i docker compose logs -f om du vill se vad som händer, och tryck Ctrl och C för att komma ur loggen utan att stänga av något. Surfa sedan till http://localhost:8000.

Tre saker att göra först

1. Skapa ett administratörskonto, för du kommer inte in utan ett: docker compose exec netbox /opt/netbox/netbox/manage.py createsuperuser. Den frågar efter användarnamn och lösenord i fönstret. Det här steget saknas i förvånansvärt många guider, och då ser det ut som att inloggningen är trasig.
2. Lägg in din egen utrustning, inte exempelutrustning. Börja med en plats och en enhet. Strukturen i NetBox är sträng, och den blir begriplig först när du försöker pressa in något du faktiskt har.
3. Registrera ditt riktiga nät under IPAM, till exempel 192.168.1.0/24, och lägg in adresserna du vet är upptagna. Det tar tjugo minuter och besvarar frågan som verktyget finns till för.

Den vanligaste fällan

Att tro att containern är säkerhetskopian. Allt du matar in hamnar i volymer som ligger kvar vid omstart och uppgradering. Men kör någon docker compose down med flaggan -v på slutet raderas volymerna, och hela registret följer med. Just den flaggan finns i var tredje guide på nätet, eftersom den är bekväm när man testar. På din riktiga installation ska den aldrig användas.

Exportera därför tabellerna till CSV med jämna mellanrum, vilket går från listvyerna, och lägg filerna där företaget sparar annat som inte får försvinna. En CSV-fil går att öppna i vilket kalkylprogram som helst, även om NetBox inte finns kvar.

En sak till om minnet: NetBox startar flera containrar samtidigt, bland annat en databas och en kö. På en dator med 8 GB minne går det, men lämna inte tio andra program öppna samtidigt och undra varför allt kryper.