Install Joinery

Three ways in. Same software, same ownership — your server, your data, in every case. We never have access.

2

Deploy on Linode with our StackScript

Free

Create a Linode and select our StackScript. It fills in a short form — admin email, password, domain — and installs Joinery while the machine first boots. A few minutes later there is a working login page with SSL, and you never open a terminal.

  • You will need: a Linode account, a domain name, and DNS you can point at the new server.
  • The server itself is billed by Linode at their usual rates, on your account.
  • You handle upgrades and backups afterwards — both are a single command, and Server Manager automates them if you would rather not think about it.
Two disclosures worth making plainly. This is our own StackScript, not yet a Linode Marketplace listing — that submission is in progress, and until it lands you select the script yourself rather than picking Joinery from the Marketplace. And Linode pays us a referral fee if you sign up through us; that is one of the ways Joinery is funded, and it costs you nothing extra.
3

Self-install

Free

Paste this into a stock Ubuntu box. That is the whole installation:

mkdir -p /tmp/joinery && \
  curl -sL https://getjoinery.com/utils/latest_release | tar xz -C /tmp/joinery && \
  cd /tmp/joinery/maintenance_scripts/install_tools && \
  sudo ./install.sh server && \
  sudo ./install.sh site mysite example.com
  • Ubuntu 24.04 or 26.04, freshly installed. The installer deliberately refuses anything else rather than half-working on it.
  • 2 GB of RAM minimum, and a domain name with DNS pointed at the box.
  • It sets up PHP, PostgreSQL, the web server, SSL and your first admin account, telling you what it is doing as it goes. Swap server for docker and add a port if you would rather run it in a container.
Full installation documentation — including mail-provider setup and the relay topology — is on the developer site.

Which one should I pick?

  Automatic — $39.99 Linode deploy — free Self-install — free
Your time Answer a few questions About 15 minutes An hour, more if mail is new to you
Skill needed None Comfortable with DNS Comfortable with a Linux server
What you maintain afterwards The server The server The server
Who holds root You You You
The do-it-yourself paths are free and always will be, and they give you exactly the same software. The $39.99 does not buy a better Joinery — it buys your afternoon back. If setting up a server sounds like a pleasant evening, take option three with our blessing.

What happens after it is installed

First run

You land on a setup page: name your site, create your account, and pick which apps to turn on. Mail wants a couple of extra answers — your domain and your sending provider — and then it tells you exactly which DNS records to add.

Bring your old life across

Import a Gmail Takeout mbox, your vCard contacts, and .ics calendars. Keep your old account running in parallel for as long as you want; nothing about the migration is one-way or urgent.

Get it on your devices

Install the mobile and desktop apps and sign in. Everything is web-accessible too, so a browser is always a valid fallback.

Backups

Your data is a folder of files and a Postgres database, so a backup is rsync plus a pg_dump — scriptable in ten minutes with tools you already know. If you would rather not, Server Manager runs scheduled backups to your own cloud bucket using a write-only key, so a compromised server cannot erase its own backup history.

Before you commit

Will my outbound mail land in spam?

No, because Joinery does not send directly from your server's IP. Outbound goes through Mailgun, Amazon SES or any SMTP smarthost you choose, with SPF, DKIM and DMARC configured during setup. Your mail lives on your server; only the last hop is borrowed, which is exactly the arrangement the self-hosting community recommends to itself.

What if I want to leave later?

Copy the folder, take a pg_dump, and export in standard formats. Your mail is mbox, your calendars are .ics, your contacts are vCards, your files are files. Nothing in Joinery is designed to make leaving expensive, and if you paid for the install there is no subscription to unwind.

What are upgrades like?

One command, or one click if you have Server Manager. Database schema changes apply themselves. The upgrade path is exercised constantly, because our own servers ride it.

What does it run on?

PHP and PostgreSQL on Ubuntu 24.04 or 26.04. A 2 GB VPS is the stated minimum; more RAM mostly buys you headroom for the AI assistant, which is optional and off by default.

Do I need the mail relay?

No. A single server is a complete, correct setup. The relay is worth adding if you would prefer your own machine never accept connections from the public internet, or if you want inbound mail held safely while your server is down. It runs on a second small instance on your own account.

Is it really free?

Self-hosting the suite for personal, household, educational or nonprofit use is free permanently — not a trial and not seat-capped. You pay for server hosting (to whoever hosts it), optionally $39.99 if you want us to do the install, and optionally for the two paid plugins. Business use needs a licence; see pricing.

Pick a rung and start.

Every one of them ends with a server that belongs to you.