USER GUIDE EM PORTAL

The EM Portal is a specialized management dashboard designed to give you direct control over your personal services on the ElectricMonk infrastructure. It acts as a bridge between your user account and the underlying APIs for SSH, CMS hosting, and email configuration.

1. SSH & Rsync Management

You can manage your SSH public keys directly from the portal. This allows you to use rsync or ssh to access your personal storage and computing resources without needing to manually edit configuration files.

How to Add an SSH Key

1. Navigate to the SSH section in the EM Portal.
2. Copy your public key (e.g., from ~/.ssh/id_rsa.pub or ~/.ssh/id_ed25519.pub on your local machine).
3. Paste the key into the text field in the portal.
4. Click Add Key.
5. Note: The SSH server will restart automatically to apply the new key. This may cause a brief interruption in existing connections.

How to Remove an SSH Key

1. In the SSH section, you will see a list of your registered keys.
2. Find the key you wish to remove and click the Delete (trash icon/button) next to it.
3. The server will restart to apply the change.

Important Details

• UID: Your account is assigned a unique User ID (starting at 10,000).
• Home Directory: Your files are stored in /cloud/<your-username>.
• Quota: Your account comes with a default quota (typically 100GB).

2. Creating a Website (CMS Hosting)

The EM Portal allows you to provision a full Content Management System (CMS) site (such as Ghost, Statamic, or WordPress) with a single click.

Provisioning a New Site

1. Navigate to the Hosting (or Ghost) section of the portal.
2. Enter a Site Name. This will become your subdomain (e.g., my-awesome-blog.electricmonk.io).
   • Constraint: Subdomains must be 3+ characters and use only lowercase alphanumeric characters or hyphens.
3. (Optional) Provide a Title for your site.
4. (Optional) If you own a custom domain, enter it in the Custom Domain field.
   • Note: If using a custom domain, you must point a CNAME record to your site-name.electricmonk.io for SSL to work correctly.
5. Select your preferred CMS Type.
6. Click Create Site.

Accessing Your Site

Once provisioning is complete (this may take a minute):

• The portal will display your Admin URL (e.g., /wp-admin/ for WordPress or /cp for Statamic).
• Crucial: The portal will also provide an Admin Email and a Randomly Generated Password.
• SAVE THESE IMMEDIATELY. For security reasons, the password will not be shown again.

3. OSX Mail Profile Generation

To simplify setting up your email, calendar, and contacts on Apple devices (macOS, iOS), the portal can generate a .mobileconfig profile.

How to Install the Profile

1. Navigate to the Mail section of the portal.
2. Click the button to Generate Apple Mail Profile.
3. A file named electricmonk.mobileconfig will download to your device.
4. On macOS: Double-click the downloaded file. Open System Settings > Privacy & Security > Profiles to approve and install the profile.
5. On iOS: Open the file and follow the prompts in Settings to install the configuration profile.

What is included in the profile?

• Email: IMAP and SMTP settings for mail.electricmonk.io.
• Calendar: CalDAV synchronization for your ElectricMonk calendar.
• Contacts: CardDAV synchronization for your ElectricMonk contacts.

Last updated: April 2026