istSOS4 Configuration Wizard is an interactive, user-friendly tool that simplifies the complex process of setting up istSOS4 servers. Generate production-ready Docker configurations through a streamlined, step-by-step interface.
- Node.js 18 or higher
- npm or yarn package manager
- Git
git clone https://github.com/istSOS/istSOS4-wizard.git
cd istSOS4-wizard/
npm installPerfect for quick configurations and development
npm run dev- Access via
http://localhost:5173
Native app experience with system integration
npm run electron-devnpm run dist| Platform | Installer Location |
|---|---|
| Windows | dist-electron/win-unpacked/istSOS4 Configurator |
| macOS | dist-electron/mac/istSOS4 Configurator-1.0.0.dmg |
| Linux | dist-electron/linux-unpacked/istSOS4 wizard |
graph LR
A[Welcome] --> B[Server Setup]
B --> C[Database]
C --> D[Auth]
D --> E[Data Mgmt]
E --> F[Sample Data]
F --> G[Performance]
G --> H[Coordinates]
H --> I[Review]
I --> J[Complete]
| Step | Focus Area | What You Configure |
|---|---|---|
| 01 | Welcome | Overview and getting started |
| 02 | Server Basics | Hostname, ports, API paths |
| 03 | Database | PostgreSQL connection details |
| 04 | Authorization | Security and authentication |
| 05 | Data Management | Versioning, duplicates handling |
| 06 | Sample Data | Test data generation |
| 07 | Performance | Redis caching, optimization |
| 08 | Coordinates | EPSG code configuration |
| 09 | Review | Validate and preview settings |
| 10 | Complete | Download and deploy |
The wizard generates everything you need for deployment:
| File | Purpose |
|---|---|
.env |
Environment variables |
docker-compose.yml |
Service orchestration |
# Step 1: Get istSOS4
git clone https://github.com/istSOS/istsos4.git
cd istsos4
# Step 2: Replace config files
# (Upload your downloaded .env and docker-compose.yml)
# Step 3: Deploy
docker-compose up -d
# Step 4: Verify
curl http://your-hostname:port/subpath/version/docs# Web Development
npm run dev # Start browser-based development
npm run build # Build web application
npm run preview # Preview production build
# Desktop Development
npm run electron-dev # Desktop app with hot reload
npm run dist # Create desktop installers
# Platform-specific builds
npm run dist:win # Windows installer
npm run dist:mac # macOS DMG
npm run dist:linux # Linux AppImageistsos4-wizard/
├── 📁 electron/ # Desktop app configuration
├── 📁 src/
│ ├── 📁 components/ # React components
│ ├── 📁 context/ # State management
│ ├── 📁 hooks/ # Custom hooks
│ └── 📁 utils/ # Utilities
├── 📁 public/ # Static assets
└── 📄 package.json # Dependencies