Download the server package

Go to seavesselmanager.com/downloads.html and download svm-server-package-latest.zip.

Extract the ZIP

Right-click the downloaded ZIP and choose Extract All. Extract to a location like C:\SVM\Server.

Run the setup script

Open PowerShell in the extracted folder and run:

powershell -ExecutionPolicy Bypass -File setup.ps1

The script will ask you a few questions:

• Server IP — your machine's local network IP (auto-detected, just press Enter)
• Deployment mode — choose vessel (on-board ship), office, or cloud
• Vessel/Server name — give it a recognisable name
• Ports — defaults are fine (3000, 4001, 8080)

Wait for startup

The script pulls Docker images (~500 MB) and starts all containers. This takes 3–5 minutes on first run depending on your internet speed.

When done you'll see the server URLs printed:

✅ SeaVesselManager is running!

  Web app:   http://192.168.1.100:3000
  API:       http://192.168.1.100:4001
  Admin:     http://192.168.1.100:8080

Open the web app

Open your browser and go to http://<YOUR_SERVER_IP>:3000

Log in with: username superadmin / password SuperAdmin

Install Docker (if not already installed)

curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER
newgrp docker

Download and run the setup

mkdir -p /opt/seavesselmanager
cd /opt/seavesselmanager
curl -fsSL -o pkg.zip https://seavesselmanager.com/downloads/svm-server-package-latest.zip
unzip pkg.zip
mv svm-server-package/* .
rm -rf svm-server-package pkg.zip
chmod +x setup.sh
./setup.sh

Answer the setup questions

Same as Windows — the script asks for your server IP, deployment mode, server name, and ports.

For a VPS: set the Server IP to your server's public IP address and choose cloud as the deployment mode.

Verify it's running

docker ps
curl http://localhost:4001/api/v1/health

You should see: {"status":"ok","version":"..."}

Open the firewall ports (if needed)

sudo ufw allow 3000/tcp
sudo ufw allow 4001/tcp
sudo ufw allow 8080/tcp

If you plan to use NGINX with a domain name (recommended for cloud), see the Cloud Setup section — in that case you only need ports 80 and 443 open.

Enter your server URL

Type the address of your SVM server, e.g. http://192.168.1.50:3000 or https://fleet.yourdomain.com

Log in

Enter your SeaVesselManager username and password. Your session is saved — you won't need to log in again unless you sign out.

Done

The app connects and loads your fleet. You can add multiple server profiles under Settings if you manage more than one installation.

Install NGINX and Certbot

sudo apt-get install -y nginx certbot python3-certbot-nginx

Create the NGINX config

sudo nano /etc/nginx/sites-available/seavesselmanager

Paste this (replace yourdomain.com with your actual domain):

server {
    listen 80;
    server_name yourdomain.com www.yourdomain.com;

    location / {
        proxy_pass http://localhost:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
    }

    location /api/ {
        proxy_pass http://localhost:4001;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        client_max_body_size 50M;
    }
}

sudo ln -s /etc/nginx/sites-available/seavesselmanager /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx

Enable HTTPS (free SSL certificate)

sudo certbot --nginx -d yourdomain.com -d www.yourdomain.com

Certbot will configure HTTPS automatically and set up auto-renewal.

Lock down the firewall

sudo ufw allow 22/tcp
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enable

Change the default password

Log in with superadmin / SuperAdmin, then go to Settings → Profile and set a strong password.

Add your first vessel

1. Click Fleet in the left sidebar
2. Click Add Vessel
3. Fill in the vessel name, IMO number, flag state, and type
4. Save

Create users

Go to Admin → Users → New User. Set a name, username, password and role.

Try the onboarding QR code

Open the admin panel at http://<SERVER_IP>:8080. It shows a QR code users can scan with the mobile/desktop client to connect instantly — no manual URL typing needed.