← Back to home

Install on your hosting

A ready-to-deploy bundle for Linux/VPS: install script, integrity check, and docs inside.

Download NewsPulse-web-archive.zip

Download NewsPulse-web-archive.zip

We publish NewsPulse-web-archive.zip.sha256 next to the ZIP — verify before unpacking.

Step by step

  1. Download the bundle

    Use the button below or the main CTA on the home page. Download only from the official domain.

  2. Unpack and run the installer

    On a Linux server unpack the archive to any directory you choose — folder name and path are up to you. From the project root run the command below — the script asks for domain (site name), database, and creates .venv, migrations, and static files. Configure SSL for the final hostname when the site is reachable.

    Project root (Linux)
    bash deploy/install_from_archive.sh
  3. Docs, web server, and HTTPS

    Full guide: docs/INSTALL_FROM_ARCHIVE.md. Use deploy/snippets/ templates for nginx and gunicorn. Free SSL: Let's Encrypt or your hosting panel; the admin UI has a «Free HTTPS» help page.

Docker: separate bundle

Container trial (SQLite, runserver). Download this bundle only if you plan to use Docker; the main site bundle does not include Docker files.

Download NewsPulse-docker-archive.zip

A separate bundle for a Docker trial — not needed for a normal hosting install. A .sha256 file is published next to it.

Telemetry and hub update checks are off by default in compose — see deploy/docker/README.md, docs/TELEMETRY.md, docs/HUB_UPDATES.md.

Integrity check (SHA256)

On Linux: sha256sum -c NewsPulse-web-archive.zip.sha256 (keep the .sha256 next to the .zip). Download only from the official newspulse.pro domain.

Verify SHA256 (Linux / macOS)
sha256sum -c NewsPulse-web-archive.zip.sha256

Windows (PowerShell): SHA256 check

In the folder with the files, compute the ZIP hash and compare it to the published .sha256 file.

Windows (PowerShell)
$got = (Get-FileHash -Path .\NewsPulse-web-archive.zip -Algorithm SHA256).Hash.ToLowerInvariant()
$line = Get-Content -Raw .\NewsPulse-web-archive.zip.sha256
$ref = ($line -split '\s+')[0].ToLowerInvariant()
if ($got -eq $ref) { 'OK: checksum matches .sha256' } else { 'Mismatch — re-download from the official site' }

Glossary

SHA256
Cryptographic checksum of the file. Matching the .sha256 file confirms the bundle is intact.
.venv
Isolated Python environment for dependencies; created by the install script.
nginx
Web server: typically terminates HTTPS and proxies requests to the app.
gunicorn
Python app server for production (instead of Django’s runserver).

Common install questions

Do I have to use /var/www/…?

No. Unpack the project to any directory you prefer. The install script asks for your domain and site name — you choose the filesystem path.

When should I enable SSL?

After the site is reachable on your domain (DNS points to the server). Certificates are issued for the final hostname — the same name you use in setup and nginx.

Why two bundles — web and Docker?

A normal install via install_from_archive.sh does not need Docker. The separate archive is for a container trial — skip it unless you plan to use Docker.

Where is the full documentation?

Inside the bundle: docs/INSTALL_FROM_ARCHIVE.md, and deploy/docker/README.md for the container.

Donate to the developers

To support the project with a voluntary contribution, open the payment page and choose any amount.