Kom igång

Från noll till inloggad på några minuter

Nav|ERP körs i Docker: databas, API och webb i tre containrar. Den här guiden är för den som installerar — IT-ansvarig, konsult eller den på företaget som är van vid en terminal.

Det här behöver ni

  • En Linux-server med Docker — en VPS eller en maskin i ert eget nätverk. Node.js och PostgreSQL behövs inte, allt körs i containrar.
  • Git, för att hämta och uppdatera källkoden.
  • Någon som är van vid en terminal. Resten av företaget behöver bara en webbläsare.
  1. Installera Docker

    Hoppa över steget om servern redan har Docker. På en ny Ubuntu- eller Debian-server:

    curl -fsSL https://get.docker.com | sh
    sudo usermod -aG docker $USER   # logga ut och in igen
  2. Hämta och konfigurera

    Hämta koden och skapa .env från mallen med kommandona nedan. Sätt därefter JWT_SECRET i .env till ett slumpat värde (openssl rand -hex 32) och WEB_ORIGIN till adressen användarna når webben på, t.ex. http://er-server:3000. Lämna NEXT_PUBLIC_API_URL tom — webben skickar själv vidare anropen till API:et. Kör ni utan HTTPS i ett internt nätverk, sätt även COOKIE_SECURE=false, annars går det inte att logga in.

    git clone https://github.com/ubbe76/Nav-ERP.git
    cd Nav-ERP
    cp .env.example .env
  3. Starta

    Första gången byggs alla images — räkna med några minuter. Databasen skapas och migreras automatiskt när API:et startar.

    docker compose up -d --build
  4. Skapa första användaren

    Gå till http://er-server:3000/register. Det första kontot blir administratör, och sidan stänger sig själv så fort en användare finns. Fler användare skapar administratören inifrån systemet.

  5. Stäng databasporten

    Ska servern nås från internet: ta bort raderna ports: - "5432:5432" under postgres i docker-compose.yml. Bara containrarna behöver nå databasen. Användarna behöver bara port 3000 (webben).

Läs in era register

Artiklar, struktur, operationer, kunder, leverantörer, priser och resurser kan läsas in från CSV, så ni slipper knappa in allt för hand.

Uppdatera

Nya versioner hämtas med git. Databasen migreras automatiskt när API:et startar.

git pull
docker compose up -d --build

Säkerhetskopiering

En administratör kan när som helst ladda ner en komplett databasdump under System → Säkerhetskopiering. Nattlig backup och återställning beskrivs i manualen.

All teknisk dokumentation

README:n i källkoden beskriver allt i detalj: miljövariabler, flytt till en ny server, tester och begränsningar.