User – Use Your Services
Dmitrii Iurco edited this page 2026-06-11 15:39:28 -04:00

Status: Active | Owner: @roof | Updated: 2026-06-11

User – Use Your Services

Optional services — email, calendar/contacts, and file storage — are installed by the cell admin. Not every cell will have all of them. Ask your admin what is available.


Finding your connection details

Log in to the cell dashboard as a peer. The peer dashboard shows the connection information for every service your admin has set up for you: server hostnames, ports, your username, and your password.

You can also call this endpoint directly once connected to the VPN:

GET /api/peers/<your-username>/service-credentials

This returns a filled-in connection info block for each service.


Email

If email is installed, you can use any standard email client (Thunderbird, Apple Mail, K-9 Mail, and others).

Your admin will give you:

  • IMAP server — for receiving mail
  • SMTP server — for sending mail
  • Username — typically you@yourdomain
  • Password — set by the admin

Standard ports:

Protocol Port Security
IMAP 993 SSL/TLS
SMTP (submission) 587 STARTTLS

Use your cell's domain as the server address. For example, if your cell is myhome.pic.ngo, the IMAP server is mail.myhome.pic.ngo.


Calendar and contacts (CalDAV / CardDAV)

If the calendar service is installed, you can use it with any CalDAV/CardDAV client (Apple Calendar, Thunderbird with Lightning, DAVx5 on Android, and others).

Protocol URL pattern
CalDAV https://calendar.<cell-domain>/
CardDAV https://calendar.<cell-domain>/

Your username and password are the same as your cell login credentials for this service.

DAVx5 on Android tip: enter https://calendar.<cell-domain>/ as the base URL and DAVx5 will find your calendars and address books automatically.


File storage (WebDAV)

If the files service is installed, you can mount it as a network drive or use a WebDAV client (Cyberduck, Finder on macOS, or any WebDAV-capable app).

URL https://files.<cell-domain>/dav/<your-username>/

Your username and password come from your peer connection info (see above).

A browser-based file manager may also be available at https://files.<cell-domain>/ — ask your admin.


A note about services and the VPN

Services are available both inside and outside the VPN. Traffic routing depends on your domain mode and the admin's configuration. If a service does not load off the VPN, try connecting to the VPN first.

Didn't work? → User – Troubleshooting