Wiozen Market

Wiozen Digital

Sell digital goods from your own storeVersion 1.0.0No reviews yet

With an Ubuntu server, your domain and the package from My licenses, your store is up in about half an hour. This page summarizes the INSTALL.md file in the package. The examples use the domain yourstore.com and version 1.0.0; use your own domain and the version you downloaded.

Requirements

A VPS running Ubuntu 22.04 or 24.04 (at least 1 GB of memory and 10 GB of free disk) and SSH access with sudo. Your domain's A record (and the www record if you use www) must point at the server's IP address. The package comes from My licenses and is unique to you; do not share it.

Node.js 22 and unzip

Wiozen Digital runs on Node.js 22.13 or a newer 22 release. node -v must print v22.13.0 or a higher v22 version.

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs unzip
node -v

User and folders

The app runs as its own user. Each version is unpacked into /opt/wiozen-digital/releases/<version>, and the current link points at the running version. Data (DATA_DIR) lives in /var/lib/wiozen-digital.

sudo useradd --system --home /opt/wiozen-digital --shell /usr/sbin/nologin wiozen
sudo mkdir -p /opt/wiozen-digital/releases /var/lib/wiozen-digital
sudo chown -R wiozen:wiozen /opt/wiozen-digital /var/lib/wiozen-digital
sudo chmod 700 /var/lib/wiozen-digital

Unpack the package

Get the package onto the server: send it from your computer with scp, or press "Get server link" on My licenses and download the link on the server with wget (the link works once, for 10 minutes). Then unpack it into its version folder, set the current link and install dependencies.

scp wiozen-digital-1.0.0.zip user@server-ip:/tmp/
# or on the server: wget -O /tmp/wiozen-digital-1.0.0.zip "<server link>"

sudo -u wiozen unzip -q /tmp/wiozen-digital-1.0.0.zip -d /opt/wiozen-digital/releases/1.0.0
sudo -u wiozen ln -sfn releases/1.0.0 /opt/wiozen-digital/current
cd /opt/wiozen-digital/current && sudo -u wiozen npm ci --omit=dev
rm /tmp/wiozen-digital-1.0.0.zip

systemd unit

Copy the ready-made unit from the package. The app runs as the wiozen user, on 127.0.0.1:3200 only, with DATA_DIR=/var/lib/wiozen-digital; it starts at boot and restarts if it crashes. The status must be active (running) and the last command must print {"ok":true}.

sudo cp /opt/wiozen-digital/current/deploy/wiozen-digital.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now wiozen-digital
sudo systemctl status wiozen-digital
curl -s http://127.0.0.1:3200/health

nginx and https

Copy the example nginx file from the package and put your domain on the server_name line. Then enable the site and get a certificate from Let's Encrypt. Do not remove the X-Real-IP line: the app reads the visitor's IP address from that header.

sudo apt-get install -y nginx certbot python3-certbot-nginx
sudo cp /opt/wiozen-digital/current/deploy/nginx.conf.example /etc/nginx/sites-available/wiozen-digital
sudo nano /etc/nginx/sites-available/wiozen-digital
sudo ln -s /etc/nginx/sites-available/wiozen-digital /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginx
sudo certbot --nginx -d yourstore.com -d www.yourstore.com --redirect

First run and license

Read the setup code and open https://yourstore.com. The wizard asks for this code, then the admin account and store details; enter https://yourstore.com as the public address. The last step activates the license: press "Get activation code" on My licenses and enter the code in the wizard (it works once, for 30 minutes). The license server checks your site at https://yourstore.com/.well-known/wiozen-proof, so the domain must point at this server and https must work.

sudo cat /var/lib/wiozen-digital/setup-token.txt

Backups

All data is in /var/lib/wiozen-digital: shop.db (with its -wal and -shm files), secret.key (the key for the encrypted settings you enter in the panel), install.key (the installation's license key; if it is lost you activate the license again) and media/. Back up the whole folder regularly and keep the backup off the server. Stop the app for a few seconds to get a consistent copy.

sudo systemctl stop wiozen-digital
sudo tar czf /root/wiozen-digital-backup-$(date +%F).tar.gz -C /var/lib wiozen-digital
sudo systemctl start wiozen-digital

Updating

A new version shows up on the panel's License page. While your updates last (one year after purchase), press "Get server link" on My licenses and use the link on the server right away. The command downloads the package, checks its signature with the Wiozen key built into the software, backs up the database and images under /var/lib/wiozen-digital/backups/, unpacks the new version into releases/<version>, runs the database migrations and switches the current link last. If any step fails, current keeps pointing at the old version and the store keeps running. When it prints "Güncellendi: 1.0.0 → 1.1.0" (updated), restart the service.

cd /opt/wiozen-digital/current
sudo -u wiozen DATA_DIR=/var/lib/wiozen-digital npm run update -- --url "https://themes.wiozen.com/wiozen-digital/download/..."
sudo systemctl restart wiozen-digital
curl -s http://127.0.0.1:3200/health

Going back to the previous version

The old version stays under releases/; point the current link at it and restart. If the new version changed the database, also restore the database from the backups/pre-update-<version>-<date>/ backup; orders taken after the backup are not in the restored database. Delete old versions and backups now and then so the disk does not fill up; keep the running version and the one before it.

sudo -u wiozen ln -sfn releases/1.0.0 /opt/wiozen-digital/current
sudo systemctl restart wiozen-digital

Troubleshooting

Start with the app's log. If the site returns 502, the app is not running; if node -v is older than 22.13, update Node. Fixes for common problems are in the last section of INSTALL.md in the package.

sudo systemctl status wiozen-digital
sudo journalctl -u wiozen-digital -n 100 --no-pager

$78.99Wiozen Digital

Buy