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:
- Run a backup.
- Unpack the new bundle and load its images.
- 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.