Venolio

Install Venolio on your own server

From an empty Linux server to a running workspace with HTTPS and backups, in about 15 minutes.

This guide takes you from an empty Linux server to a running Venolio workspace with HTTPS and backups. It assumes you can connect to the server over SSH.

What you need

  • A Linux server with Docker Engine and Docker Compose v2, Bash and Python 3. 2 CPU cores and 8 GB of RAM give a team of up to 50 plenty of room.
  • A domain name you control, for example workspace.example.com, pointing at the server.
  • Ports 80 and 443 open in the firewall.
  • Your Venolio release bundle and licence file from your account.

Unpack the release

Copy the bundle to the server and check it against the SHA-256 checksum shown in your account:

sha256sum venolio-1.0.0.tar.gz
tar -xzf venolio-1.0.0.tar.gz
cd venolio

Load the images that come with the release:

docker load -i images.tar

Keep venolio.licence in this folder, next to compose.yml.

Configure

Generate a .env file with fresh secrets. The script refuses to overwrite an existing file and never prints the secrets:

./scripts/setup.sh

Open .env and set your own values:

COMPOSE_PROJECT_NAME=venolio
[email protected]
ADMIN_NAME=Your Name
PUBLIC_URL=https://workspace.example.com
SITE_ADDRESS=workspace.example.com
SECURE_COOKIES=true
HTTP_BIND=0.0.0.0
HTTP_PORT=80
HTTPS_BIND=0.0.0.0
HTTPS_PORT=443

Start

docker compose up -d --no-build --wait
docker compose ps

All three containers should report healthy. The proxy requests the HTTPS certificate for your domain on its own; the first start can take a minute while it does.

Sign in and invite your team

Open your domain in a browser and sign in with ADMIN_EMAIL and the initial password from .env. Change the password, then add your colleagues in Settings.

When everyone has an account, you can turn on VENOLIO_PRIVATE_MODE=true to block new accounts, public pages, public forms and booking links.

Back up

Back up the database and files with one command, and copy the result off the server:

./scripts/backup.sh

Schedule it with cron, for example every night at 02:30:

30 2 * * * cd /opt/venolio && ./scripts/backup.sh

Restore with ./scripts/restore.sh. Try a restore on a spare machine once, so you know it works before you need it.

Update

When a new release appears in your account:

  1. Run a backup.
  2. Unpack the new bundle and load its images.
  3. Run docker compose up -d --no-build --wait.

Database migrations run on start. If anything looks wrong, restore the backup and start the previous images.

Need help?

Write to us. If you would rather not do this yourself, we can install it for you.

Your workspace, on your terms.

Start a 30-day trial on your own server, or talk to us about hosting. No card needed for the trial.